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How to Write an NT Service. 6 


NT services are special programs that can run at startup before any users log on. They 
fill the role that demons perform under UNIX. However, NT services are also key to NT 
security — if you want to create a program that can perform privileged operations on 
behalf of unprivileged users, you’ll probably have to implement it as a service. This 
article explains NT services and provides a template to help you get your first service 
up and running quickly. 

Paula Tomlinson 

Context Switch Performance on NT and Win95 .... 19 

Conventional wisdom says NT is portable and secure but slow, whereas Win95 is Intel- 
specific but fast and small. It would certainly be reasonable to expect that a fundamen¬ 
tal operation like process switching would be faster under Win95. This benchmark 
shows that conventional wisdom is not always right, and NT process switches are 
faster than under Win95 — a lot faster! 

Piaw Na 

A Delphi File-Drop Component. 29 

Delphi lets you use inheritance to build upon existing Delphi objects, even built-in 
Delphi objects. Paul demonstrates by taking the standard TPanel class and giving it the 
ability to handle files dropped from File Manager or Explorer. 

Paul Sobolik 

Bypassing Win95 Printer Device Drivers. 57 

Even if you use the PASSTHROUGH escape code, Windows printer drivers invariably 
add their own header and trailer data. If you want to really send raw data to the printer, 
you need to use some DDK functions. We showed how to do this for Windows 3.1 in 
our August 1995 issue, and here’s the revised version for Win95. 

Ron Burk 



Tech Tips. 36 

Trevor Harmon supplies a C++ class for microsecond timing, based on 
QueryPerformanceCounter(). Terje W. Mathisen offers a faster, smaller version of the Jim 
Lawless utility for encoding ASCII files into a DEBUG script. V. Ramachandran 
describes how to trap the Return key for dialog child controls. 

Leor Zolman 

Books in Brief. 45 

Programming the Windows 95 User Interface, by Nancy Winnick Cluts; The 
Microprocessor: A Biography, by Michael S. Malone (reviewed by Paula Tomlinson); 
Migrating to Windows 95, by David Kipping. Plus, readers talk back about books. 

Ron Burk 

Windows Bug of the Month. 51 

Roger Alley revives our old Windows Bug of the Month column, peering into the guts 
of Windows 95 to see why it doesn’t always work. Though Win95 is supposed to be 
more robust than Windows 3.1, Mike Stratoti shows that passing a metafile device con¬ 
text to UpdateCol ors () works OK under Windows 3.1, but hangs Win95l Roger reveals 
that only tuck keeps Windows 3.1 from crashing too. 

Roger Alley 
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Bug++ of the Month. 53 

The compiler bugs that make simple arithmetic look hard continue. Last month, Visual 
C++ had trouble with multiplication. This month, an equally simple stretch of code 
causes Borland C++ v4.5x to incorrectly report that 1 plus 4 is equal to 9! Mark shows 
the problem is an incorrect jump in the generated code. 

Mark Nelson 

Understanding NT. 61 

This column concludes Paula’s look at how to write correct Plug and Play code that 
will work with the next version of NT. Topics covered include how to send your own 
WM_DEVICECHANGE message with BroadcastSystemMessagef), hardware configurations, 
WM_DISPLAYCHANGE, and WM_POWERBROADCAST. 

Paula Tomlinson 
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From the Editor 
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Final reminder: ronb@rdpub.COIH is now a defunct address. Make sure you use 70302. 2566@COm- 
puserve if you want to send email to me directly (press releases go to ma rtha@rdpub. com, gener¬ 
al letters to the magazine go to wdl etter@rdpub.com, subscription/renewal problems go to 
wdsub@rdpub. com). AT Are you an assembly language programmer at heart, frustrated 
with multi-megabyte Windows . exe's? Take heart then, for Steve Gibson (well-known 
Info World columnist and author of SpinRite) has been busily working on creating non-trivial 
Windows apps in assembly language. His first such product is ChromaZone, and you can 
download the demo from file czdemo . zi p in Library 7 ("R&D Publications") of forum SDFO- 
RUM on CompuServe. It's a wild toolkit that lets end users create a fantastical Windows 
screen saver, all accomplished in a little over 100Kb! AT I love the computer magazine 
business — you never know what's going to happen next. For example, a while back, I 
received a copy of a magazine that gave an award to Borland C++ v5.0. Then, a week or so 
later I received my first beta copy of Borland C++ v5.0! More recently, I was leafing through a 
magazine and discovered my all-time favorite book review: "We haven't seen this book yet, 
but if you're creating Web pages, it's worth a look." No wonder I've found product and book 
reviews so difficult and time-consuming — I thought reviewers actually had to examine the 
dam things! AT Don't forget to grab our latest set of SDK annotations; by the time you 
read this, there should be at least 100 in there. On CompuServe, you can get them from Library 
7 (R&D Publications) in forum SDFORUM, or from Library 2 (Public Utilities) in forum WINS- 
DK. In either case, the filename is sdkann . zi p. ArmTater, the automatic tool for adding the 
annotations to your help file, is included. AT Remember how much simpler program¬ 
ming was supposed to get with Win32? No more memory-model hassles, no more NEAR and 
FAR baloney, etc. Well, don't worry, Microsoft has worked hard to make sure you have new 

baloney to worry about. My favorite is all the_decl spec() incantations Microsoft invented 

for 32-bit DLLs. Whenever the choice is between making their compiler/linker do the work or 
making programmers do the work, Microsoft always piles busy work on programmers! AT 
Our FTP site has changed. As of last November, the new site became ftp. mf i. com, and our 
code disks are in pub/wi ndev! AT Readers provide a lot of the raw technical content of the 
magazine, but there's a couple of ways readers contribute that we rarely mention. First, if you 
buy a product and let the vendor know you saw their ad here, that tells the vendor that WDJ 
is a good way to reach experienced Windows programmers. Second, if you tell another pro¬ 
grammer about WDj and they end up subscribing, our circulation goes up, which attracts 
more advertisers, which gives us the money to print more pages, which . . . well, it's just the 
sort of vicious cycle we like to see. Loyal readers are the main reason this magazine survived 
its first couple of years, but they are no less important today as we try to find ways to deliver 
more value to more programmers. AT In the November issue, I asked for someone to 
write an article on how to add your own objects to the shell's namespace, an undocumented 
feature Microsoft reserves for its own applications. To my surprise, Microsoft has indicated 
that they are going to go ahead and document how to do this. Does this mean Microsoft has 
turned into a company that actually responds to developers' needs? I'm not counting on it, but 
I'm not going to look a gift horse in the mouth — one less thing to reverse engineer is always 
good news. If they really deliver as promised, then kudos to Microsoft! AT The 
Association of Magazine Editors bylaws require me to express an opinion on the future of those 
$500 diskless Web terminals that are supposed to kill off the PC. My two bits: the main thing 
they forgo (disk space) just keeps getting cheaper and cheaper, while the main thing they need 
(memory) hasn't budged in price for years. Doesn't sound like a formula for huge success to 
me. AT Under Windows 95, functions like IsWi ndow() and GetCl 1 entRectt) don't return 
TRUE as they are documented to do, but NT gets it right. Global ReAl 1 0 C () fails to zero out mem¬ 
ory properly under Windows 3.x and Win95, but NT gets it right. For users, the difference in 
quality between the two operating systems is perhaps an abstract thing, but if you spend a lot 
of time at the API level, the difference in quality is clear and concrete. Too bad NT is stuck 
having to support poor designs thrown together for Win95. 

Ron Burk 

Editor 

70302.2566@compuserve.com 


Drop in on our brand new Web site! 
You’ll find us at: 

http://www.wdj.com 

You’ll find information and excerpts from the 
current issue, along with links to WDJ code, 
including our SDK Annotations. 

Check it out — and let us know what you 
think. 
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End Sub 
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Windows NT 




How to Write an NT Service 

Paula Tomlinson 



Borland C++ v4.52 
Visual C++ v2.2 


Windows 95 and Windows NT share a common API for the most part, but there 
are important features that are only available under NT. One such feature, NT ser¬ 
vices, not only offer the NT equivalent of UNIX "daemons," but also make it possi¬ 
ble to create programs that can perform privileged operations on behalf of less priv¬ 
ileged users. Services are a logical choice for the server side of client/server NT soft¬ 
ware. This article explains what NT services are and provides a template program 
that you can easily alter to get your own NT service up and running. 

What Is a Service? 

The term "service" in Windows NT is used to denote both a special kind of Win32 
process and Windows NT kernel-mode device drivers. In fact, a component of the 
operating system known as the "service controller" (or "service control manager," or 
SCM) is used to load and control both types of services. For the rest of this article, 
when I use the term "service," I will be referring to the special Win32 processes (not 
device drivers). In that context, a service is more or less a program that gets execut¬ 
ed by NT (as opposed to getting directly executed by a user), and that responds to 
special requests to start, pause, or stop execution. 

Services have some special capabilities beyond those of the typical Win32 process. 
For one thing, you can tell NT to start your service when the system loads, before 
any users have logged on. That makes services a good choice for software that needs 
to start automatically and run constantly in the background, whenever the system is 
up. For example, if you wanted to write a program that continually monitored 
changes to files in a particular directly (using the FindFi rstChangeNoti ficati on () 
function), you might want to implement that program as a service so that users 
could not make unobserved changes to the file before your moniter program started 
running. 

Another important feature of services has to do with NT security. When you log 
on to NT, your account gives you certain privileges. Every program you execute has 
only those privileges, no more. Under UNIX, it's possible to create a privileged pro¬ 
gram that unprivileged users can execute, but you can't do that under NT (there's 
no "setuid bit" in NT). 
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Services, however, get executed by NT (not directly by 
you) and are associated at installation time with a particular 
account. In effect, a service logs on as a separate user, so 
though your account may not have the privileges needed to 
access some special file, you can ask NT to start up a service 
that does have the necessary privileges to do so (assuming a 
privileged user created such a service and gave you permis¬ 
sion to use it). When you want to allow users to perform some 
privileged operation or access some special file in very 
restricted circumstances, consider writing a service. That way, 
the user gets to perform the privileged operation — but only 
via your program. (The new NT function LogonUserO offers 
an alternative, but less secure, method of writing programs 
that acquire the privileges of some other account.) 

Another handy feature of services is that they obey a com¬ 
mon API for starting, pausing, stopping, 
etc. Once you write your service, any 
user can use the standard "Services" 
control panel applet (see Figure 1) to 
control it (assuming you have the neces¬ 
sary privileges). For instance, the user 
can pause a service and then later con¬ 
tinue it. The configuration information 
(such as when and how a service starts) 
can be viewed and modified via the ser¬ 
vice controller. Services can even estab¬ 
lish elaborate dependency lists on other 
services and control their load order 
among other services. What's even nicer 
is that much of the capability of the ser¬ 
vice controller is made available to appli¬ 
cations in the form of a service controller 
API. These routines are implemented as 
an RPC server and are thus extensible to 
other machines (i.e., you can control ser¬ 
vices on other machines if you have suf¬ 
ficient privilege). The "Services" control 
panel applet uses these routines to allow 
users to view and configure all the ser¬ 
vices currently installed on a system. 
That's one reason why services are an 
attractive choice for the server side of 
client/server software; if you implement 
your server program as a service, all the 
work of letting client-side users adminis¬ 
ter your program (start it up, check if it's 
running, and so on) is already done for 
you. 

There are many uses for services. 
Background processes that used to be 
implemented as DOS TSRs or perhaps 
UNIX daemons are good candidates for 
Windows NT services. Other examples 
of processes that are well suited as ser¬ 
vices include RPC servers, communica¬ 
tions programs, utility programs such as 
virus scanners, and backup programs. 
The Windows NT operating system itself 
uses services extensively. The EventLog 
service is a classic example of a Win32 
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Listing 1 instsrv.c — Program to install a service 

//include <windows.h> 


//include <stdio.h> 

GetWindowsDirectory(szWinDir, MAX PATH); 

//include <tchar.h> 

_stprintf(szImagePath, TEXT("%s\\system32\\%s.exe"), 

//include "srvctmpl .h" 

szWinDir, GENSRV_ServiceName); 

// Borland C++ v4.52 does not support VC-specific 

if ((hService - CreateService(hSCManager, 

// Unicode functions tprintf, etc. 

GENSRV ServiceName, 

#ifdef _BORLANDC_ 

GENSRV DisplayName, SERVICE ALL ACCESS, 

// therefore, don’t compile this with Unicode enabled! 

SERVICE WIN32 OWN PROCESS, SERVICE DEMAND START, 

// define _tprintf printf 

SERVICE ERROR IGNORE, szImagePath, NULL, NULL, 

// define _stprintf sprintf 

NULL, NULL, NULL)) -- NULL) { 

//end if 

_tprintf(TEXT("CreateService Failed, %d\n"), 


GetLastError ()) ; 

VOID main(VOID) 

return; 

SC_HANDLE hSCManager - NULL, hService - NULL; 


TCHAR szWinDir[MAX_PATH]. szImagePath[MAX PATH]; 

CloseServiceHandle(hService); 


CloseServiceHandle(hSCManager ) ; 

if (( hSCManager - OpenSCManager ( NULL, NULL, 

tprintf(TEXT("%s installed successfully\n"). 

SC_MANAGER_CREATE SERVICE)) — NULL) { 

szImagePath); 

_tprintf ( TEXT ( "OpenSCManager Failed\n" )) ; 

} 

return; 

} 

/* End of File */ 


installed before you've even written it, but demonstrating 
how services are installed highlights some of the major design 
decisions and characteristics of a service. The service con¬ 
troller manages services by maintaining a database of infor¬ 
mation in the registry. Each service has a subkey under 
HKEY_LOCAL_MACHINE\System\CurrentControl Set\Servi ces. 
Each service entry contains standard information that tells the 
service controller how to manage the service. Although some 
developers install their services by writing information direct¬ 
ly to the registry, I strongly discourage this practice. The loca- 


service. It is implemented as a service within the services. exe 
process (which contains several other services) and uses RPC, 
so that the event log routines it exports are available to remote 
machines. Of course, the EventLog service must be available 
before logon so that it can receive events that occur while the 
system is booting. The network subsystem also makes exten¬ 
sive use of services to manage network communication. 

Installing a Service 

It might seem a bit odd to discuss how something is 
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tion and format of the service database is internal to the 
Windows NT operating system and thus could change in 
future versions of the operating system. A much safer practice 
is to use the service controller routines. 

In instsrv.c (Listing 1) I wrote a very simple console appli¬ 
cation to demonstrate installing a service programmatically. 
You must call OpenSCManager () first to establish a connection 
with the service controller. When I call CreateServiceO, the 
service controller adds the information I've specified about 
this new service to its service database. In addition to the han¬ 
dle to the service controller, CreateServiceO requires a long 
list of other parameters, including several forms of the service 
name. The second parameter is the name that the service con¬ 
troller uses internally and by convention is usually the file 
name of the service without the .exe extension. The third 
parameter is the name you want to be displayed in the ser¬ 
vices applet for users to see. The eighth parameter is the fully 
qualified path of the service file (by convention, services are 
placed in the windows\system32 directory). In srvctmpl.h 
(Listing 2), I added definitions for both the internal service 
name ("WDJSrvc") and the display name ("WDJ Sample 
Service") of my sample service so that I can refer to these 
names in several files. 

The fourth parameter to CreateServiceO specifies what 
kind of access to your service you're granting to other process¬ 
es. When a process attempts to query or control this service, 
the service control manager will check the access token of the 
calling process against the access you specified when you cre¬ 
ated the service. For my sample service, I chose to grant broad 
access by specifying SERVIC E_ACCESS_ALL. 

Since this is a Win32 service (as opposed to a kernel-mode 
device driver), the only two choices for service type are SER- 


Figure 2 Overview of how a service works 


service controller service.exe 



VICE_WIN32_0WN_PR0CESS and SERVICE_WIN32_SHARE_PROCESS. 
Since my sample executable image will only contain a single 
service, I specified SERVICE_WIN32_0WN_PR0CESS. 

The dwSta rtType parameter controls how the service will be 
started. The options available to Win32 services are SER- 
VICE_AUTO_START (the service will be started when the system 
starts), SERVI CE_DEMAND_START (the service will be started if 
another process starts it), and SERVI CE_D I SAB LED (the service is 
installed but can't be started). I chose SERV ICE_DEMAND_START 
for the sample service since it's not required to be running 
before logon. The dwErrorControl parameter is not really rele¬ 
vant for services that are demand started, since this parameter 
controls how the system will respond if the service fails to 
start during boot. Just to be safe, I specified 
SERVICE_IGNORE_ERROR so that any problems my service might 
encounter while starting will not affect the rest of the operat¬ 
ing system. 

Although my simple service is a stand-alone, you can also 
specify dependencies and load order in the call to 
CreateServiceO. Dependencies can refer to specific services 
or groups of services. So in addition to specifying services that 
your service is dependent on, you can also specify that your 
service is part of a group of services which another service can 
claim a dependency on. Further, you can specify a tag value 
which indicates what order your service is loaded in among 
its group. 

Finally, you can specify what account the service will run 
under when it's started. Remember that your service may 
start before a user even logs on, so services get to make selec¬ 
tions about their own logon account. When the service process 
is started, the service controller logs onto the account specified 
and attaches the resulting access token to the newly started 
service. The default account, "LocalSystem," is the only 
option available to services of type 
SERVICE_WIN32_SHARE_PR0CESS. Single service processes can 
specify an account in either the local (built-in), primary, or 
trusted domain. If the account has a password, then you'll be 
required to provide that in the 1 pPassword parameter. One dis¬ 
advantage of specifying a particular logon account is that you 
would need to reinstall (or reconfigure using 
ChangeServiceConfig( ) routine) your service if the account 
name or password changed. Remember that your service will 
have only the privileges of that account. So, for example, if 
you install a database library that your service uses, make sure 
the service's account has the permissions needed to access the 
library. Also remember that your service may run before any 
user has logged on, which means that the registry key 


Listing 2 srvctmpl.h — Definitions for 
generic sen/ice 


#define GENSRVJerviceName TEXT("WDJSrvc") 

ifdefine GENSRV_DisplayName TEXT("WDJ Sample Service") 

// prototypes 

BOOL ServicelnitializationtDWORD, LPTSTR *); 

VOID ServiceTermination(VOID); 

DWORD MainServiceThread(LPDWORD); 

/* End of File */ 
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HKEY_LOCAL_USER may not be set to what you expect; ideally, 
your service will only depend on machine-specific registry 
information, not user-specific registry information. 

If CreateServiceO returns successfully, the service is 
installed. A demand start service can then be immediately 
controlled by calling the service controller routines or using 
the "Services" control panel applet (or the console "net" com¬ 
mand). CreateServiceO will fail if the service is already 
installed. Services can only be demand started by calling the 
StartServiceO service controller routine, not by starting them 
from the command line. 

The Service Interface 

A service may start running before any users are logged on, 
so services generally don't have an _ 

extensive user interface and are often 
written as console programs, rather 
than windowed programs. Apart from 
that, the main thing that distinguishes a 
service from an ordinary NT program is 
that a service cooperates with the ser¬ 
vice control manager. Figure 2 shows a 
rough overview. 

The situation is made slightly com¬ 
plicated by the fact that you are allowed 
to create a single .exe that contains 
more than one logical service. To 
accomplish this, your .exe has to pass 
the service controller the address(es) of 
the function(s) that do the work of the 
service(s). The service controller then 
uses each of these functions to create a 
thread that does the actual work of the 
service. 

Here is a more detailed description 
of the process: immediately after a ser¬ 
vice starts up, it calls 
StartServiceCtrlDi spatch( ) to notify 
the service controller that it is execut¬ 
ing, and to provide the addresses of the 
service functions. It sounds a little con¬ 
fusing, but StartServi ceCtrl Dispatch () 
does not return until much later. That's 
because it starts a thread for each of 
your services, and then waits for them 
to terminate. In fact, 

StartServi ceCtrl DispatchO does not 
just wait for the threads to terminate; it 
also waits for any incoming commands 
aimed at your service (e.g., pause, con¬ 
tinue, stop) and notifies the appropriate 
thread of such events. To make things 
simpler, I'll assume in the rest of this 
discussion that your .exe is only pro¬ 
viding one service. 

So, while your ma inf) is still waiting 
for StartServiceCtrlDispatch() to 
return, a separate thread starts up and 


calls the function whose address you passed to 
StartServiceCtrlDispatchO. This function is expected to do 
the main work of your service, but first it has to establish a 
protocol for communicating with the service controller. It does 
this by passing the address of a callback function to 
Regi sterServi ceCtrl HandlerO, which returns a handle. As 
your service thread is executing, the service controller may 
have to call the callback function to notify your service that it 
should pause, stop, continue, etc. Your service thread will 
have to pass the handle that Regi sterServi ceCtrl HandlerO 
returned to SetServi ceStatus () to inform the service con¬ 
troller that it has responded to the notification correctly. 

It seems odd that you have to explicitly call 
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SetServiceStatust ) to respond to a notification from the ser¬ 
vice controller, rather than just returning some value from the 
callback function. The idea is that your service may need a bit 
of time to respond to any individual request. Thus, for exam¬ 
ple, when you receive a notification to pause your service, you 
are expected to respond immediately with a code that means 
"the pause is pending." Then, when you finally achieve the 
paused state, you are supposed to call SetServi ceStatus () 
again with a code that means "I'm paused now." In fact, you 
can even use SetServiceStatust ) to tell the service controller 
how long you think it will take to respond to a given request; 
if it takes longer than that, the service controller can then 
assume something went wrong in your service. 

Service Template 

I've created a sample service that you can revise to create 
your own service. To make it easier to reuse this code, I've 
structured the service in two files. The first file, srvctmpl .c 
(Listing 3), contains the standard header part of a service and 
can be used directly with little modification for most basic ser¬ 
vice applications. The second file, wdjsrvc.c (Listing 4), is a 


Design Decisions for Services 

When you are creating a service that is not a device driver, 

here are the things you have to decide before calling 

CreateService( ) to install your service in the service controller 

database: 

• What name will you use for your service? The convention is to use 
the name of the module containing your service (e.g., 
mysrvi ce. exe uses a service name of mysrvice). 

• What display name will you use for your service? This is just a text 
string that the "Services" applet will display to users. 

• Where will you store your service? By convention, most services 
reside in the wi ndows\system32 directory. 

• What access will you grant to your service? The easiest (but least 
secure) choice is SERVICE_ALL_ACCESS, which allows all the pos¬ 
sible operations on your service. 

• Are you creating a single executable tint exports more than one service? 
If so, you will use a service type of SERVICE„WIN32_SHARE_PR0CESS 
rather than SERVICEJIN32_0WN_PR0CESS. 

• Does your sendee need to start automatically when the system 
starts? If so, you will pass SERVICE_AUT0_START instead of 
SERVICE_DEMAND_START. 

• If your service starts automatically at boot time, you need to 
decide how important any failure is. SERVICE_IGNORE_ERROR is 
the parameter to use for demand-load services, or if you want 
to log any error, but not display a message to the user. 

• Does your service depend on any other service? If your service 
starts automatically at boot time, you can control the load 
order. 

• If your service does not share a . exe with other services, you can 
specify what account the service will run under. Otherwise, if 
you selected SERV I CE_W I N32_SHARE_PR0C ESS for the service 
type, the service will run under the default account: 
"LocalSystem". If the account has a password, you will also 
have to pass that to CreateServi ce(). Make sure the account 
has the privileges and access that your service needs to exe¬ 
cute (e.g., ODBC access). □ 


trivial example of the service-specific code you would provide 
to fill out the rest of the service. 

By definition, a service is supposed to call 
StartServiceCtrlDispatcher( ) from its mainO routine and it 
has only 30 seconds in which to do so. If a service fails to call 
StartServiceCtrl Di splatch( ) within 30 seconds, the service 
controller will assume the process died and terminate it. For 
this reason you should put off as much initialization work 
as possible until later. A common guideline is to only per¬ 
form initialization tasks that are common to all services sup¬ 
plied by this process (which is none for my sample process 
since it contains only one service) before calling 
StartServi ceCtrl Di spatch (). If you really must do lengthy 
initialization tasks, then you may need to create a separate 
thread to do so. 

StartServi ceCtrl Di spatch( ) takes only one parameter, 
which is an array of at least two SERVICE_TABLE_ENTRY struc¬ 
tures. Each SERVICE_TABLE_ENTRY structure describes a service 
that is provided by the calling process, and the last one in the 
array is a sentinel (all values NULL). For simplicity, in srvctm¬ 
pl .C, I've assumed the process provides only one service. If 
your application calls for multiple independently managed 
services, it's better to provide all services in a single process 
rather than in multiple processes because threads are less 
expensive to create and manage than processes are. The 
1 pServiceName field specifies the internal name of the service 
(supplied in the call to CreateServi ce()) and the 
1 pServi ceProc field specifies the service's main entrypoint. To 
indicate that there are no more services, you should provide 
one additional SERV I CE_TABLE_ENTRY that contains NULL for 


Listing 3 srvctmpl.c — Stub functions for 
generic service 


^include <windows.h> 

#include <stdio.h> 
finclude "srvctmpl.h" 

// private prototypes 

BOOL NotifySCM(DWORD, DWORD, DWORD); 

VOID ServiceMain(DWORD, LPTSTR *); 

VOID ServiceHandler(DWORD); 

HANDLE hDoneEvent = NULL, hThread = NULL; 

DWORD dwCurrentState; 

SERVICE_STATUS_HANDLE hService; 

//. 

void main(void) 

{ 

SERVICE_TABLE_ENTRY ServiceTable[] - { 

{GENSRV_ServiceName, (LPSERVICE_MAIN_FUNCTION)ServiceMain}, 
{NULL, NULL} 

}; 

// connect to the service control manager 
StartServiceCtrlDispatcher(ServiceTable); 

} 

//. 

VOID ServiceMain(DWORD dwArgc, LPTSTR *1pszArgv) 

{ 

DWORD Threadld; 

if (HhService - RegisterServiceCtrlHandler( 

GENSRV_ServiceName, 

(LPHANDLER_FUNCTION)ServiceHandler))) 

return; 

NotifySCH(SERVICE_START_PENDING, 0, 1); 

if (!Servicelnitialization(dwArgc. 1pszArgv)) 
return; 
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both fields. For processes that provide a single service, the 
1 pServi ceName parameter is supposed to be ignored, but I've 
experienced problems with this in the past so I always specify 
the service name explicitly. 

Once StartServiceCtrlDispatch! ) is called, it manages the 
service via the service's main entrypoint and its handler rou¬ 
tine and only returns if the service fails to start or when the 
service is stopped. If the process supports multiple services, 
Sta rtServi ceCtrl Dispatch!) won't return until all services 
have stopped. The thread that StartServiceCtrl Dispatch! ) is 
called from is also significant. This is the thread that subse¬ 
quent control requests will be sent to, so the service's handler 
routine will be in the same thread that made the call to 
StartServiceCtrl Dispatch! ). In other words, when your call¬ 
back function gets notified of a service control request, it is 
executing in the context of the thread that originally called 
StartServiceCtrlDispatch! ) (usually the main thread of your 
process), not the separate thread that was started for your service. 

The service controller then creates a new thread in which to 
execute the service's main entrypoint routine. Since you spec¬ 
ify the service's entrypoint routine in the call to 
StartServi ceCtrl Di spatch! ), you can give it any name you 
want, but it must have the following prototype: 

VOID ServiceMain(DWORD dwArgc, LPTSTR *1pszArgv) 

The very first thing ServiceMain!) should do is call 
RegisterServi ceCtrl Handler!). This routine takes as parame¬ 
ters the service name and the name of the service handler rou- 


Listing 3 continued 


NotifySCM(SERVICE_START_PENDING, 0. 2); 

if ((hDoneEvent-CreateEvent(NULL,FALSE,FALSE.NULL)) — 0) 
return; 

NotifySCM(SERVICE_START_PENDING, 0, 3); 

if ((hThread - CreateThread(0, 0. 

(LPTHREAD_START_ROUTINE)MainServiceThread. 0. 0. 
&ThreadId)) — 0) { 

CloseHandle(hDoneEvent); 
return; 

} 

NotifySCM(SERVICE_RUNNING. 0. 0); 

WaitForSingle0bject(hDoneEvent, INFINITE); 

CloseHandle(hThread): 

ExitThread(Threadld); 

CloseHandle(hDoneEvent); 
return; 


//. 

VOID ServiceHandler(DWORD fdwControl) 

{ 

switch(fdwControl) { 

case SERVICE_C0NTR0L_ST0P: 

OutputDebugString("Stop\n"); 

NotifySCM(SERVICE_ST0P_PENDING. 0. 1); 
SetEvent(hDoneEvent); 

NotifySCM(SERVICE_ST0PPED, 0, 0); 
break; 

case SERVICE_C0NTR0L_PAUSE: 
OutputDebugString("Pause\n"); 

NotifySCM(SERVICE_PAUSE_PENDING, 0. 1); 

MessageBox(NULL, "Pausing", "Test", MB_0K); 


CLICK! 
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The first thing your customer sees, is the 
installer. Eschalon 
Setup Pro's standard, 
professional inter¬ 
face makes them feel 
right at home. We 
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windows with use¬ 



We believe building the installation should 
never be harder than writing the application. 
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Listing 3 continued 

SuspendThread(hThread); 


NotifySCM(SERVICE_PAUSED, 0. 0); 

//. 

break; 

BOOL NotifySCM(DWORD dwState. DWORD dwWin32ExitCode, 


DWORD dwProgress) 

case SERVICE CONTROL CONTINUE: 

i 

OutputDebugString("Continue\n"); 

SERVICE STATUS ServiceStatus; 

NotifySCM(SERVICE_CONTINUE_PENDING, 0. 1); 


ResumeThread(hThread); 

// fill in the SERVICE STATUS structure 

NotifySCM(SERVICE_RUNNING. 0. 0); 

ServiceStatus.dwServiceType - SERVICE WIN32 OWN PROCESS; 

break: 

ServiceStatus.dwCurrentState - dwCurrentState - dwState; 


ServiceStatus.dwControlsAccepted - SERVICE ACCEPT STOP | 

case SERVICE CONTROL INTERROGATE: 

SERVICE ACCEPT PAUSE CONTINUE | SERVICE ACCEPT SHUTDOWN; 

OutputDebugStri ng( "Interrogated"); 

ServiceStatus.dwWin32ExitCode - dwWin32ExitCode; 

NotifySCMCdwCurrentState, 0, 0); 

ServiceStatus.dwServiceSpecificExitCode - 0; 

break; 

ServiceStatus.dwCheckPoint - dwProgress; 


ServiceStatus.dwWaitHint - 3000; 

case SERVICE CONTROL SHUTDOWN: 


OutputDebugString("Shutdown\n"); 

// send status to SCM 

ServiceTermination!); 

return SetServiceStatus(hService. &ServiceStatus); 

break; 

} 

} 

i 

/* End of File */ 


tine. It returns a handle to the service, which is used in sub¬ 
sequent calls to SetServiceStatusO. SetServiceStatusl) is 
called to let the service controller know the current state of the 
service. These are the states that a service can be in at any 
given time: 

SERVICE.STOPPED 

SERVICE_START_PENDING 

SERVICE_RUNNING 

SERVICE_PAUSED_PENDING 

SERVICE_PAUSED 

SERVIC E_C0NTINUE_PEND ING 

S ERVIC E_STOP_PENDING 

The pending states are used to indicate that the service is in 
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the process of transitioning between two states. In these cases, 
you should make frequent calls to SetServiceStatusO, incre¬ 
menting the dwCheckPoi nt field each time. This lets the service 
controller know that the service is still making progress 
towards transitioning to the next state. The dwWaitHint field 
lets the service controller know how long to wait before 
expecting another SetServiceStatusO call. To simplify this 
repeated calling of SetServiceStatusO, I wrote a wrapper 
function called NotifySCM(). NotifySCMO also saves the cur¬ 
rent status in a global parameter for use later. 

In ServiceMainO, I will be transitioning from the SER- 
V IC E_START_P END I NG to the SERV I CE_RUNN I NG state. After calling 
Regi sterServi ceCtrl Handl er( ) to register Servi ceHandl erO as 
my service's handler routine, I call a predefined 
Servicelnitialization routine. The prototype is defined in 
srvctmpl . h (Listing 2). I intend for this routine to be provided 
by the service-specific part of the code, which will then be 
linked to the template header part of the code to produce the 
complete service. Servi celnti al i z a t i on () is where you would 
put service-specific code to perform initialization tasks. I pass 
along any command-line parameters that were passed in to 
ServiceMainO. 

If the service-specific initialization succeeds, I create an 
event that I will use later to signal when the service has ter¬ 
minated. Then I create a separate thread that will perform the 
real work of the service. Again, this thread routine will be pro¬ 
vided by the service-specific part of the code. In my simple 
custom service example, MainServiceThread( ) simply wakes 
up every five seconds and outputs a Y to any running debug¬ 
ger. You would put your own code inside 
MainServiceThreadt ) to do whatever it is your service is sup¬ 
posed to do at runtime. All this time, ServiceMaint ) has been 
frequently calling Noti fySCM (which calls SetServiceStatus) to 
let the service controller know the service is still in the process 
of starting. Once the main service thread is successfully creat¬ 
ed, I can let the service controller know my service is official¬ 
ly running. 

Creating a separate thread (in addition to the thread creat¬ 
ed to run the service) to do the main work of the service is not 
required, but it can be convenient. For one thing, I can't return 
from ServiceMainO until my service has been stopped, so I 
want to be able to have the thread that is running 
ServiceMainO go into a wait loop until my termination event 
is signaled (I'll discuss this more later). As I'll describe later. 
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having a separate thread perform the main work of the service 
is very convenient for pausing and continuing the service. 

The last routine that the service needs to provide is the call¬ 
back function, or handler. Since service handlers often per¬ 
form the same basic tasks. I've included the handler as part of 
the service template code. If your service has more complex 
needs, then the handler in s rvctmpl. C can be extended accord¬ 
ingly. A service can receive control requests from the service 
controller itself or from applications that call the service con¬ 
troller API routines. The most common example of this is the 
control panel "Services" applet (the "Devices" applet per¬ 
forms a similar task for kernel-mode drivers), which uses the 
service controller routines to allow users to view and control 
any services currently installed on the system. Since I speci¬ 
fied SERVICE_ALL_ACCESS when I created this service, I've stat¬ 
ed that my service can respond to all the standard control 
requests. All services must respond at least to the 
SERVICE_C0NTR0L_INTERROGATE control 
request. 

If my service receives a control 
request to pause, I simply suspend the 
main thread by calling SuspendThread(). 

As always, I need to inform the service 
controller of my change in state. 

Likewise, when the service is continued 
from a paused state, I simply resume 
the thread by calling ResumeThread(). 

The SERVICE_C0NTR0L_INTERROGATE 
control simply represents the service 
controller's prerogative to call a service 
at any time and request its current sta¬ 
tus. For this reason, whenever my ser¬ 
vice changes state, I update the global 
dwCurrentState value and return this 
information during 

SERVICE_CONTROL_INTERROGATE requests. 

The SERVICE_C0NTR0L_SHUTD0WN event 
is sent when the operating system itself 
is in the process of shutting down. 

According to the SDK information, 
your service has about 20 seconds to 
complete any cleanup. If you aren't 
done yet, shutdown will proceed any¬ 
way. Since the shutdown event is so 
time-critical, only critical cleanup activ¬ 
ities should be performed (flushing 
files, etc.). 

The SERV I CE_C0NTR0L_ST0P request is 
sent when the service itself is explicitly 
stopped. At this point, I call the service- 
specific ServiceTerminationd routine 
to perform any routine cleanup tasks 
and then signal the termination event 
so that the WaitForSingleObject( ) in 
Servi ceMainf) can be released. 

Services can also respond to user- 
defined control codes in the range of 
128-255. 

To get started writing your own ser¬ 
vice, follow these steps to modify the 
code supplied with this article: 

• Insrvctmpl. h, change the text for GEN - 


SRV_Servi ceName to the name of your service, and the text for 
GENSRV_Di spl ay Name to the display name of your service. 

• In wdjsrvc.c, insert any initialization code you need to per¬ 
form in the function Servicelni ti al izati on(). 

• In wdjsrvc.c, insert the code that does the main work of 
your service into Mai nServi ceThread(). 

•In wdjsrvc.c, insert any termination code you need 
into ServiceTerminationt). 

The code disk (see the Table of Contents for availability) 
includes build.bat, a batch file that builds the code for either 
Visual C++ v2.2 or Borland C++ v4.52. 

Debugging a Service 

Once a service is running, most debuggers provide a mech¬ 
anism for attaching to the running process. At that point you 
can set breakpoints and debug the service in a normal fashion. 
The tricky part is debugging a service during startup. Even if 
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Listing 4 wdjsrvc.c — Framework code for 
generic service 


#include <windows.h> 

#include <stdio.h> 

#include "srvctmpl.h" 

TCHAR szSomeThreadlnfo[] - TEXT("SomeThreadInfo”); 

//. 

#ifdef _BORLANDC_ 

# pragma argsused 
#endif 

BOOL ServicelnitializationCDWORD dwArgc, LPTSTR *1pszArgv) 
{ 

OutputDebugString(TEXT("ServerInitialization\n")); 
return TRUE; 

} 

// 

VOID ServiceTermination(VOID) 

{ 

OutputDebugString(TEXT("ServiceTerminatlon\n")); 

} 

//. . 

DWORD MainServiceThreadt LPDWORD ThreadParam) 

{ 

OutputDebugString((LPTSTR)ThreadParain); 

while (TRUE) { 

SIeep(5000); 

OutputDebugString(TEXT(”.\n")); 

} 

} 

/* End of File */ 
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your service is an auto-start service, during the debugging 
phase it is much simpler to install it as a demand start service 
until you're sure the service initialization is working properly. 

Although it's possible for services to communicate directly 
with the user, most services will communicate important sta¬ 
tus and error information via the event logging routines (refer 
to the References section for information on the event logging 
routines). I will discuss in more detail the rules for how a ser¬ 
vice can interact with the user as well as service debugging 
techniques in a future "Understanding NT" column. 

If you can't seem to get any service at all to start, make sure 
the account you are logged on to has the "log on a service" 
privilege. To check this, select User Rights from the Policies 
menu, then select Show Advanced User Rights, and add that 
right if necessary. 

If you have the Microsoft Developer's Network CD-ROM, 
check out sc. exe, a utility that lets you interactively make calls 
to the service controller functions. For example, you can type: 

sc qc MyService 

to dump information about a service called "MyService," to 
see if it was installed correctly, sc.exe provides more control 
and more detailed information than the "Services" control 
panel applet. 

Managing Services from an Application 

In some cases, a companion application that manages the 
service can be a powerful combination. To communicate with 
an installed service, the application calls OpenServiceO, spec¬ 
ifying the internal service name. The returned handle can be 
used in calls to the other service controller routines. You might 
also decide to have the application and the service communi¬ 
cate via shared memory or other mechanisms. 

In addition to starting, stopping, pausing, and resuming a 
service, you can also query or modify its configuration. You 
can query the list of running services or a list of services that 
are dependent upon a given service. See the SDK documenta¬ 
tion for a list of the available service controller API routines. 

Summary 

The fact that Win32 services can be specified to start when 
the system starts is, alone, a very useful feature. The fact that 
services have a uniform interface that can be managed and 
controlled via a standard set of Win32 routines and that ser¬ 
vices can define complex sets of dependencies and load order¬ 
ing makes them a very powerful tool. The biggest potential 
drawback of services is that they aren't supported in 
Windows 95. On the other hand, since services are often used 
in distributed application and server environments, they are 
particularly well suited to Windows NT. 

Further Reading 

Brain, Marshall. Win32 System Services, the Heart of Windows 

NT. Englewood Cliffs, NJ: Prentice Hall, 1994. 

Microsoft Corporation. Win32 SDK Reference. 

Tomlinson, Paula. "Using Windows NT Event Logging." 

Windows/DOS Developer's Journal, July 1994 (vol. 5, no. 7), 

pp. 19-32. □ 


February 1996 
























Windows NT 


Context Switch Performance 
on NT and Win95 


Pi aw Na 


=G3= 

Borland C++ v4.52 




Windows 3.x offered what some people dubbed "one-at-a-time multitasking" — the 
scheduler could not guarantee that any Windows task but the foreground task would 
get much CPU time. The Win32 API allows for more robust schedulers, making it more 
feasible to break a large program into multiple processes. Windows 95 and Windows 
NT also offer the ability to create multiple threads of control within a single process 
(sometimes called "lightweight processes"), which provides another option for struc¬ 
turing control in an application. 

Processes and threads do not come free, however. When one process passes control 
to another, the operating system has to switch from one process context to another. For 
example, the operating system may have to change various page tables so that the 
memory claimed by one process is not visible in the address space of another. All 
threads within a single process share the same address space, but they do have some 
register state, so thread context switching is not free either. As more programmers take 
advantage of multiple processes or multiple threads to structure their applications 
(perhaps implicitly, via OLE interprocess communications), it is important that they 
understand the overhead of context switching. In this article, I present benchmarks for 
measuring context switching performance, and describe the results of running the 
benchmarks on various configurations and processors. (For a dissection of part of the 
Win95 context switch code, see Matt Pietrek's "Windows 95 System Programming Secrets 
[IDG Books] p. 305.) 

Why Does Performance Matter? 

Because it is sometimes easier to engineer many small executables rather than one 
big one, many products (such as Microsoft Visual C++) really consist of multiple 
processes communicating with each other. These processes may need to communicate 
large amounts of data among themselves, and file I/O is generally a slow way to 
accomplish that. Interprocess communication (IPC) on a single machine is best accom¬ 
plished via shared memory in Win32. Named pipes and mail slots are not available in 
Windows 95 — only the client side is implemented, the assumption being that the serv¬ 
er will be a Windows NT machine. TCP/IP pipes are available and the prevalence of 
Internet providers is making TCP/IP installations more and more common, but 
TCP/IP requires a lengthy and complicated installation (how many people know the 
IP number of their DNS server?). Furthermore, TCP/IP performance is slow — in the 
milliseconds performance range, which is much higher than the overhead of a function 
call — while accessing shared memory can be done almost instanteously, making full 
use of virtual memory and the paging system. 

The problem with using shared memory for IPC then becomes that of signaling the 
other process when valid data has been placed in the shared memory, and then wait- 


Piaw Na is a Windows software engineer at Pure Software, a leading provider of 32-bit soft¬ 
ware quality tools. Currently, the company's products support the leading UNIX develop¬ 
ment platforms with Windows versions expected in 1996. He can be reached via the Internet 
at piaiv@netcom.com. 
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Listing 1 send.c — The sender side of the benchmark 

// For interesting results, you must compile with 

LARGE INTEGER end; 

// optimization off: 

i nt i ; 

// cl /Zi /MT -DWIN32 <file> 

double tks; 

// bcc32 <file> 

SetEvent(event); 

//include <windows.h> 

QueryPerformanceCounter(&start); 

//include <stdio.h> 

for (i - 0; i < 10000; i++) { 


WaitForSingleObject!recevent, INFINITE); 

/* Borland v4.5 needs a fix */ 

SetEvent(ackevent); 

#1f defined! BORLANDC ) &S ( BORLANDC <- 0x0460) 

WaitForSingleObject!recevent, INFINITE); 

typedef struct FOO_LARGE_INTEGER { 

SetEvent(ackevent); 

DWORD LowPart: 

WaitForSingleObject ( recevent, INFINITE); 

LONG HighPart; 

SetEvent!ackevent ) ; 

} F00_LARGE_INTEGER: 

} 

QueryPerformanceCounter(&end); 

//define LARGEJNTEGER FOO_LARGE_INTEGER 

tks = ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Receiver: Average // of microseconds " 

//end if 

"context switch with threads - %f\n", 


(tks / (double) freq.LowPart)*1000000.0 ) ; 

HANDLE event; 

HANDLE recevent, ackevent; 

SetEvent(event); 

} 

LARGEJNTEGER freq; 

void f(void) {} 

void receive!void) 

{ 

#1fdef BORLANDC 

LARGEJNTEGER start; 

// pragma argsused 


ing for the reply. If one process tries to read data while anoth¬ 
er process is in the middle of modifying that data, incorrect 
data might be used for a computation. In the worst case, if two 
processes are trying to modify the same piece of data in 
shared memory simultaneously, data corruption can occur. To 
eliminate these possibilities, many programs use the remote- 
procedure-call paradigm, where one process calls a function 
in another process. Each call/reply pair requires two inter¬ 


process context switches. For multiple threads running in the 
same process, every synchronization whereby a thread blocks 
while waiting for a mutex or semaphore held by another 
thread also requires two thread-level context switches. In fact, 
a common multithreading paradigm, the producer-consumer 
relationship, can be viewed as two threads calling each other 
via IPC as needed. The speed of the operating system in per¬ 
forming context switches is a major factor in determining how 
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Listing 1 continued 


#endif 

int main(int argc, char **argv) 
{ 

HANOLE semi, sem2, sem3; 
HANDLE mul, mu2, mu3; 


LARGE.INTEGER start; 

LARGE_INTEGER end; 

int i; 

double tks; 

DWORD foo; 


// Figure out performance counter frequency 
QueryPerformanceFrequency(&freq); 
fprintf(stderr. "Performance counter frequency = low: 
"%d high: %d\n", 
freq.LowPart, freq.HighPart); 

// create main syncrhonization event 

event = CreateEvent(0, FALSE, FALSE, "Start"); 


sem3 - CreateSemaphore(0, 0, 1, "Sem3"); 
SetEvent(event); 

ReleaseSemaphore(sem2, 1, 0); 

WaitForSingleObject(event, INFINITE); 

QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 

ReleaseSemaphore(seml, 1, 0); 

WaitForSingle0bject(sem2, INFINITE); 
ReleaseSemaphore(sem3, 1, 0); 

WaitForSingle0bject(seml, INFINITE); 
ReleaseSemaphore(sem2, 1, 0); 

WaitForSingle0bject(sem3, INFINITE); 

} 

QueryPerformanceCounter(&end); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
QueryPerformanceFrequency(&freq); 
fprintf(stderr, "Average # of microseconds context " 
"switch using semaphores = %f\n", 

(tks / (double) freq.LowPart)*1000000.0); 


// now do context switch using events 
recevent - CreateEvent(0, FALSE, FALSE, "RecSync"); 
ackevent = CreateEvent(0, FALSE, FALSE, "AckSync"); 
WaitForSingleObject(event, INFINITE); 

QueryPerformanceCounter(&start); 
for (i =0; i < 10000; 1++) { 

SetEvent(recevent); 

WaitForSingleObject(ackevent, INFINITE); 
SetEvent(recevent); 

WaitForSingleObject(ackevent, INFINITE); 
SetEvent(recevent); 

WaitForSingleObject(ackevent. INFINITE); 

} 

QueryPerformanceCounter(&end); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Average # of microseconds context " 
"switch using events - %f\n”, 

(tks / (double) freq.LowPart)*1000000.0); 

// now for semaphores 

semi - CreateSemaphore(0. 0, 1, "Semi"); 

sem2 - CreateSemaphore(0, 0, 1, "Sem2"); 
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// mutexes 

mul = CreateMutex(0, TRUE, "Mutexl"); 
mu2 - CreateMutex(0, TRUE, "Mutex2"); 
mu3 = CreateMutex(0, TRUE, "Mutex3"); 

SetEvent(event); 

ReleaseMutex(mu2); 

WaitForSingleObject(event, INFINITE); 

QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 

ReleaseMutex(mul); 

WaitForSingleObject(mu2, INFINITE); 
ReleaseMutex(mu3); 

WaitForSingleObject(mul, INFINITE); 
ReleaseMutex(mu2); 

WaitForSingle0bject(mu3, INFINITE); 

} 

QueryPerformanceCounterUend); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
QueryPerformanceFrequency(&freq); 
fprintf(stderr, "Average # of microseconds context " 
"switch using mutexes - %f\n", 

(tks / (double) freq.LowPart)*1000000.0); 

// the "catch" program will now terminate --- 
// we'll continue and investigate 
// inter-thread context switching 
CreateThread(0, 0, (LPTHREAD_START_R0UTINE) receive, 
0, 0, &foo); 

WaitForSingleObject(event, INFINITE) ; 

QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 

SetEvent(recevent); 

WaitForSingle0bject(ackevent, INFINITE); 

SetEvent(recevent); 

WaitForSingleObject(ackevent, INFINITE); 
SetEvent(recevent); 

WaitForSingleObject(ackevent. INFINITE); 

) 

QueryPerformanceCounter(&end); 

WaitForSingleObject(event, INFINITE); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Sender: Average # of microseconds " 
"context switch with threads - %f\n", 

(tks / (double) freq.LowPart)*1000000.0); 

// check out system call performance 
QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 

GetTickCount(); 

GetTickCountO; 

GetTickCount(); 

} 

QueryPerformanceCounter(&end); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Average # of microseconds system " 
"call = %f\n", 

(tks / (double) freq.LowPart)*1000000.0); 

// null function call performance 
QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 
f(); f(); f(); 

} 

QueryPerformanceCounter(&end); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Average # of microseconds - %f\n", 
(tks / (double) freq.LowPa rt)*1000000.0); 

} 

/* End of File */ 
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readily IPC or multiple threads can be 
used by an application. 

Synchronization 

Constructs 

Win32 provides three major syn¬ 
chronization constructs: events, sema¬ 
phores, and mutexes. Events are objects 
that can be signaled. An auto-reset 
event automatically resets after a 
process that's been waiting for it has 
been signaled. Semaphores are counted 
synchronization constructs that allow 
multiple threads/processes access to a 
resource. Each thread that does not get 
immediate access to the semaphore is 
placed in a queue. Semaphores are fre¬ 
quently used to limit the number of 
threads attempting to grab a limited 
resource. Mutexes are like semaphores, 
but only one thread is allowed to a own 
a mutex at a time. 

Windows lets you easily acquire any 
of these synchronization constructs by 
using a WaitForSingleObjectt ) or 
WaitForMultipleObjectsf ) API call. 
This allows a program to wait for an 
event or grab a semaphore or mutex 
using the same API, a kind of C-level 
polymorphism possible because all sys¬ 
tem objects are referred to via a 
Windows handle. 

Event Context-Switching 
Benchmark 

The benchmark I wrote to measure 
the overhead of context switching in 
Windows 95 and Windows NT is in 
send.C (Listing 1) and catch.c (Listing 
2). The first program (send.exe) creates 
three events and then waits for the first 
one, which is the rendezvous event. The 
second program (catch.exe) starts up 
and obtains handles to the same events 
by calling OpenEvent( ), then signals the 
rendezvous event by calling 
SetEvent (). This unblocks send.exe and 
allows the initial benchmark to begin. 

The first benchmark measures the 
speed of using events to synchronize 
control between two processes. The 
sender signals an event that unblocks 
the receiver, then waits for an acknowl¬ 
edgment event to be signaled. The 
receiver waits on an event and, when 
the sender signals that event, signals 
the acknowledgment event. Thus, con¬ 
trol ping-pongs back and forth between 
the two processes as fast as possible. 
The programs measure the time 
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Listing 2 catch.c — The receiver side of the benchmark 

// run this after running send.exe 

event - OpenEvent(EVENT_ALL_ACCESS. FALSE, "Start"); 

Urielude <windows.h> 

// now for event-based context switching 

//include <stdio.h> 

recevent - OpenEvent(EVENT ALL ACCESS, FALSE, "RecSync"); 
ackevent - OpenEvent(EVENT ALL ACCESS, FALSE, "AckSync”); 

/* Borland v4.5 needs a fix */ 

SetEvent(event); 

#1f defined! BORLANDC ) 88 ( BORLANDC <- 0x0460) 

QueryPerformanceCounterUstart); 

typedef struct F00 LARGE INTEGER { 

for (i - 0; i < 10000; i++) { 

DWORD LowPart; 

WaitForSingleObject(recevent, INFINITE); 

LONG HighPart; 

SetEvent(ackevent); 

} F00_LARGE_INTEGER; 

WaitForSingleObject(recevent, INFINITE); 

SetEvent(ackevent); 

//define LARGEJNTEGER F00_LARGE_INTEGER 

WaitForSingleObject(recevent, INFINITE); 

SetEvent(ackevent); 

#endif 

] 

#i fdef _BORLANDC_ 

QueryPerformanceCounter(&end); 

# pragma argsused 

tks = ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 

lendlf 

fprintf(stderr, "Average // of microseconds context " 

int main(int arge, char **argv) 

"switch using events - %f\n", 

{ 

HANDLE event; 

(tks / (double) freq.LowPart)*1000000.0); 

HANDLE recevent, ackevent; 

// semaphore based context switching 

HANDLE semi, sem2, sem3; 

WaitForSingleObject(event, INFINITE); 

HANDLE mul, mu2, mu3; 

semi - OpenSemaphore(SEMAPHORE ALL ACCESS, FALSE, "Semi"); 

LARGE INTEGER start; 

sem2 - OpenSemaphore(SEMAPHORE ALL ACCESS, FALSE. "Sem2"); 

LARGE INTEGER end; 

sem3 - OpenSemaphore(SEMAPHORE ALL ACCESS. FALSE. "Sem3"); 

LARGE INTEGER freq; 

SetEvent(event); 

i nt i; 

WaitForSingleObject(sem2, INFINITE); 

double tks; 

QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 

QueryPerformanceFrequency(&freq); 

WaitForSingleObject(semi, INFINITE); 

ReleaseSemaphore(sem2, 1, 0); 

// open synerhonization event 

WaitForSingle0bject(sem3, INFINITE); 


required to do this 30,000 times. 

When all the iterations are finished, the performance 
counter is read again, and the elapsed time per context switch 
is calculated. The discrepancies between the numbers report¬ 
ed by the sender and the receiver can be attributed to the 


printf () that could happen between processes, before the 
second process gets control and reads the performance counter. 
I consistently use the lower number of the two when using 
these benchmarks. However, the differences should be negligi¬ 
ble, given the relatively large number of ping-pongs that occur. 
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Listing 2 continued 


ReleaseSemaphore(seml, 1, 0); 

WaitForSingleObject(sem2, INFINITE); 
ReleaseSemaphore(sem3, 1, 0); 

} 

QueryPerformanceCounter(&end); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Average # of microseconds context " 
"switch using semaphores - %f\n", 

(tks / (double) freq.LowPart)*1000000.0); 

// mutex oriented context switching 
WaitForSingleObject(event, INFINITE); 
mul = OpenMutex(MUTEX_ALL_ACCESS, FALSE. "Mutexl"); 
mu2 - OpenMutex(MUTEX_ALL_ACCESS, FALSE. "Mutex2"); 
mu3 - OpenMutex(MUTEX_ALL_ACCESS, FALSE. "Mutex3"); 
WaitForSingle0bject(mu2, INFINITE); 

SetEvent(event); 


QueryPerformanceCounter(&start); 
for (i - 0; i < 10000; i++) { 

WaitForSingleObject(mul, INFINITE); 
ReleaseMutex(mu2); 

WaitForSingleObject(mu3, INFINITE); 
ReleaseMutex(mul); 

WaitForSingleObject(mu2, INFINITE); 
ReleaseMutex(mu3); 

} 

QueryPerformanceCounter(&end); 
tks - ((end.LowPart - start.LowPart) / 3.0)/ 10000.0; 
fprintf(stderr, "Average # of microseconds context " 
"switch using mutexes - U\n", 

(tks / (double) freq.LowPart)*1000000.0); 

} 

/* End of File */ 


The performance counter is a 64-bit integer. The unit of the 
performance is a clock "tick," which varies between imple¬ 
mentations of Win32. However, you can get the number of 
ticks in one second by calling QueryPerformanceFrequency( ). If 
you run any of the benchmarks for such a long time that the 
lower 32-bit counter overflows, then you will get a negative 
number for the average context switch time. You would really 
have to run the benchmark for hours before this would occur. 

After measuring the overhead of context switches using 
events, the programs perform similar loops using semaphores 
and then mutexes and the synchronization object. Finally, the 
receiver program terminates, but the sender creates a new thread 
and uses that to measure the overhead of thread context switches. 


Why Three Mutexes? 

You may wonder why three mutexes (and three sema¬ 
phores) were used in the semaphore and mutex portions of 
the benchmarks. Indeed, when I first wrote the mutex version 
of the benchmark, I used just two mutexes. Unfortunately, two 
mutexes are not enough to force a context switch between two 
processes. To understand why requires a little thought. 

Suppose you use two mutexes, called mutexl and mutexZ, to 
force control to transfer between two processes, processl and 
process2. Initially, processl owns mutexl, and process2 owns 
mutex2 and is waiting for mutexl, so process2 is blocked. Here 
is how the initial events might happen: 
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Table 1 Context switching overhead under Win32 


Events 

Semaphores 

Mutexes 

Thread 

Function 

Syscall 

P90 W95 

222.28 

221.79 

245.92 

172.83 

0.26 

0.21 

P90 NT 1057 

83.62 

81.24 

94.06 

56.56 

0.26 

0.32 

W95/NT ratio 

2.66 

2.73 

2.61 

3.06 

1.00 

0.66 

486/100 W95 

202.91 

208.08 

227.01 

202.00 

0.32 

0.40 

486/100 NT 944 

74.88 

78.11 

76.88 

75.04 

0.32 

0.34 

W95/NT ratio 

2.71 

2.66 

2.95 

2.69 

1.00 

1.18 

DP W95 

216.18 

240.07 

237.10 

154.37 

0.26 

0.21 

DP NT 1057 

106.85 

103.08 

105.31 

116.02 

0.26 

0.32 

W95/NT ratio 

2.02 

2.33 

2.25 

1.33 

1.00 

0.66 

P66 W95 

309.46 

316.31 

356.28 

311.8 

0.44 

0.96 

P66 NT 1057 

113.83 

111.37 

120.38 

99.96 

0.43 

0.86 

W95/NT ratio 

2.72 

2.84 

2.96 

3.12 

1.02 

1.12 

386/40 W95 

1344.29 

1372.16 

1495.24 

1283.36 

4.66 

5.72 

386/40 NT 1057 

604.12 

610.59 

636.87 

591.67 

3.5 

3.62 

W95/NT ratio 

2.23 

2.25 

2.35 

2.17 

1.33 

1.58 


That's where things go wrong. 
Although this sequence of events forces 
the operating system to transfer control 
to process2, once process2 owns both 
mutexes, there is no way to force con¬ 
trol back to processl, since at that point 
processl owns no synchronization 
objects that process2 can wait on. 

I was puzzled by this, and, after I 
found out what was wrong, I tried var¬ 
ious ways of rearranging the order of 
releasing and acquiring the two mutex¬ 
es, but to no avail. A colleague and I 
then sat down and drew out a state dia¬ 
gram representing the two processes, 
proving that a repeating context switch 
could not be forced to occur using just 
two mutexes. We came to the conclu¬ 
sion that at least three mutexes (or sem¬ 
aphores) were required to force a con¬ 
text switch between the two processes. 

Function Calls and System 
Calls 


processl releases mutexl 
// now process2 is not blocked 
processl waits for mutex2 
// now processl is blocked, so 
// control WILL switch to process2 
process2 acquires mutexl 
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A Delphi File-Drop Component 

Paul Sobolik 


Delphi's component model provides ample opportunity to customize and extend 
existing Delphi objects, once you understand how. This article shows how to create 
an extension of Delphi's TPanel class that allows the panel to accept files dragged 
from the Windows File Manager. 

Introduction 

A Delphi component has three levels, each aimed at a different potential user. 
These levels correspond exactly with the visibility of the component's parts. 

The first level, which is aimed at the application builder, consists of the public 
(and published) parts of the component. At this level, the component really seems 
like a physical object: the application builder picks it up from the palette and drops 
it onto a form, ft may have properties that customize its appearance or behavior, but 
the component will function as it is, without any effort on the part of the application 
builder. 

The second level is made up of the properties and methods in the protected part 
of the component's class definition. It is aimed at programmers who will use the 
component in a modified form by subclassing it. This level is probably the trickiest 
to design, because it requires you to anticipate how others might want to use the 
component — or at least guess at what aspects are the most likely candidates for 
modification. Designing in hooks to facilitate future modifications will make your 
component that much more useful. 

The third level of a Delphi component is the private section. Unlike the other two 
levels, this level doesn't really have an "audience": it's basically nobody's business 
but your own. This is where the logical interfaces of the other levels are implement¬ 
ed. Writing this section is more like typical Pascal or C programming: library, API, 
and other functions are called; bits are twiddled; things get done. 

What Is TShellDropPanel? 

TShellDropPanel is a simple and useful example of a Delphi component; the 
source code is in shel 1 drp.pas (Listing 1). ATShel 1 DropPanel descends from the stan¬ 
dard Visual Control Library component TPanel, but has the additional ability to 
accept files dropped from the Windows File Manager. 

When the application builder places a TShellDropPanel onto a form from the 
Delphi component palette, it is more or less indistinguishable from a TPanel . It has a 
variety of border options, can display text, can contain other components, and so 
forth; it even inherits Delphi objects' built-in drag-and-drop abilities, facilitating 
communication between other components on the form. A close look at the object 
browser, though, shows that TShel 1 DropPanel has one property and one method that 
TPanel does not. 

The published property Accepti ng is of the standard Pascal type Bool ean. Setting 
this property to True indicates to the system that the TShel 1 DropPanel will accept files 
dropped from the File Manager; setting it to False means that it won't accept such 
files. The File Manager changes the mouse cursor to an appropriate picture when the 
user drags a file or a list of files over a window that has given notification that it is 
accepting files. This lets the user know that files can be dropped there. If the user 
goes ahead and drops the files on the TShellDropPanel, the component's 


Paul Sobolik writes small programs and gives them away. He has been at it for over ten 
years. Send him email at 103134.1713@compuserve.com or psobolik@aol.com. 
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OnDropFilesO method is called, if one is defined. The 
OnDropFi 1 es () method is TShel 1 DropPanel's other new pub¬ 
lished property. OnDropFilesO is of the user-defined type 
TDropFi 1 esEvent, which is defined as follows: 


TDropFi1esEvent = procedure! 
Sender : TObject; 

Files : TStringList; 
Location : TPoint 
) of Object: 


Listing 1 Demonstrating TShellDropPanel 

unit ShellDrp; 

procedure Register; 

interface 

implementation 

uses 

uses Shel1 API; 

SysUtils, WinTypes, WinProcs, Messages, Classes, Graphics, 


Controls, Forms, Dialogs, ExtCtrls; 

procedure Register; 


begin 

type 

RegisterComponentsC'PSobolik', [TShellDropPanel]); 

TDropFi1esEvent = 

end; 

procedure(Sender : TObject; Files : TStringList; 


Location : TPoint) of Object; 

procedure TShellDropPanel.SetAccepting(b : Boolean); 

TShellDropPanel = cl ass(TPanel) 

begin 

private 

if b <> FAccepting then 

FAccepting : Boolean; 

begin 

FOnDropFiles : TDropFilesEvent; 

FAccepting := b; 

procedure SetAccepting(b : Boolean); 

DragAcceptFi1es(Handle, FAccepting); 

procedure DoDropFi1es(Msg : TWMDropFiles); 

end; 

procedure WMDestroy(var Msg : TWMNoParams); 

end; 

message WM_DESTROY; 


procedure WMDropFi1es(var Msg : TWMDropFiles); 

procedure TShellDropPanel.DropFi1es(Fi1es : TStringList; 

message WM DROPFILES; 

Location : TPoint); 

protected 

begin 

procedure DropFi1es(Fi1es : TStringList; 

if Assigned(FOnDropFiles) then 

Location : TPoint); dynamic; 

FOnDropFi1es(Self, Files, Location); 

published 

end; 

property Accepting : Boolean read FAccepting 


write SetAccepting; 

procedure TShellDropPanel.WMDropFi1es( 

property OnDropFi1es : TDropFilesEvent read 

var Msg : TWMDropFiles); 

FOnDropFiles 

begin 

write FOnDropFiles; 

Inherited; 

end; 

DoDropFi1es(Msg); 


end; 
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This method's parameters contain information about the file 
drop event. Sender is the TObject that triggered the event, 
which will nearly always be the TShel 1 DropPanel itself. Files 
is a TStringList that contains a list of the files that were 
dropped. It's up to the application builder to do something 
with this list during this method call. If the list needs to be 
stored, it must be copied because the TStri ngLi st indicated by 
Files is destroyed after the method returns. The last parame¬ 
ter, Location, is a TPoint that indicates precisely where in the 
TShel 1 DropPanel the mouse pointer was when the files were 
dropped. 

TShellDropPanel's Implementation 

TShel 1 DropPanel 's second-level interface is pretty thin. It's 
difficult to imagine what further func¬ 
tionality such a specialized component 
could need. Nevertheless, 

TShel 1 DropPanel does have a protected 
procedure, DropFi 1 es( ), intended as a 
hook for future descendants. The low- 
level function that responds to the 
user's file-dropping calls DropFi lest) 
instead of calling the OnDropFilesO 
event directly. DropFi lest) just verifies 
that the OnDropFilesO handler is 
defined and then calls it with the appro¬ 
priate parameters. The subclassing pro¬ 
grammer can change the behavior of 


Listing 1 continued 


procedure TShel1DropPanel.DoDropFi1es(Msg : TWMDropFiles); 
type 

TStringBuffer - Record 
case Integer of 

0: (bCount: Byte; cArray : array[0. .254] of Char;) 
1; (str : String); 

end; 

var 

IstFiles : TStringList; 
pt : TPoint; 
wFileCt : Word; 
i : Integer; 


begin 

try 


sb : TStringBuffer; 
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run large programs, such as a word processor or 
a report generator, from inside your main program 
with less than a 10Kb memory overhead 

• Microsoft C/C++, FORTRAN, Pascal, Assembler, 
Borland C/C++. Assembler, Symantec C++, 

Watcom C/C++ and CA-Clipper support 

• full support for CodeView, Soft-ICE and 
Periscope debuggers 

• serial number encryption 

• creation of demonstration versions 

• over 500 pages of documentation and complete 
on-line help in a Windows .HLP file 


programs, so you can share code 
and data between applications 
and easily update parts of your 
program. 

Proven Results! 


□ Microsoft C++ CATALOG.EXE 
linked with Blinker's compression 







.EXE and .DLL compression 


The fastest Windows & DOS 
linker and a royalty-free 
DOS extender!! 

Compatible with C, C++, Pascal, 
FORTRAN, CA-Clipper and ASM, 
Blinker 4.0 is a royalty-free DOS 
extender, the worlds fastest 
Windows linker and an award- 
winning dynamic overlay linker, 
all in one unique product for 
one low price! Virtually elimi¬ 
nate programming “down time” 
with the fastest link times for 
Windows, DOS-extended and 
DOS programs. 

Call today to see why over 
60,000 programmers are 
already using this award¬ 
winning product! 


o I 

ADVISOR 



The world's first network 
library for Visual Basic, 
Delphi, 

C/C ++ and 
CA-V0!! 

Make your 
Visual Basic, 

Delphi, 

C/C++, CA-VO and 
CA-Clipper programs 
NetWare-aware the 
easy way, with the latest 
version of this award¬ 
winning network library. 
NOVLIB 3-0 features over 
450 functions, written in 
highly optimized C and 
ASM code, for printing, 
security, mapping, 
messaging, IPX/SPX 
handling, accounting 
and much more and is 
the only network library 
which brings the power 
of Novell to Windows, 

DOS extended and real 
mode DOS programs 
for all these languages. 

If you program for Novell 
networks, you need 
NOVLIB! Call Blink/wc 
today for your free sample 
program! 

i= Save $50! ■ 

Blinker 4.0 $249 
NOVLIB 3.0 $249 

TEL: 1-804-747-6700 

FAX: 1-804-747-4200 



Blink inc 

8001 W. Brood St., Rkhmond VA 23294 
In Europe contort: Blink/nc Ltd. 
TEL:+44 1222 712444 • FAX.+44 1222 700 


Graphics copyright Blink, inc 1995. Blinker and NOVLIB are trademarks of ASM, Inc. All other trademarks acknowledged. 
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if DragQueryPoint(Msg.Drop. pt) then 
{only accepts drop in client area} 
begin 

IstFiles TStringList.Create; 
try 

wFileCt DragQueryFile(Msg.Drop, SFFFF, Nil, 0); 

for i 0 to wFileCt - 1 do 

begin 

sb.bCount Byte(DragQueryFi1e(Msg.Drop, i, 
sb.cArray, sizeof(sb.cArray))); 

IstFiles.Add(sb.str); 
end; 

DropFilesdstFiles, pt); 
finally 
IstFiles.Free; 
end; 


Add ZylNDEX full-text 
retrieval technology to 
your application. 

ZylNDEX is the most powerful full-text 
search technology available. The result of 
11 years' of R&D and market experience. 
ZylNDEX is the performance leader in: 

• Search Query Speed 

• Query Power 

• Index Storage Efficiency 

• Document Format Support 



ZylNDEX 

Developer's Toolkit 
In U.S. 1-800-894-6602 
In Europe 011 (31)20-696-6277 


the component by overriding this dynamic procedure — to 
modify or filter the list of files, for example — and then call¬ 
ing OnDropFi 1 es( ). Thus, the behavior of the component could 
be modified at a pretty low level, without the programmer's 
needing to understand the Windows drag-and-drop protocol. 

The rest of the implementation of TShel 1 DropPanel is in the 
private section. This section contains all of the awkward little 
details involved in dealing with files dropped from the File 
Manager. If you only want to use this component to imple¬ 
ment File Manager drag-and-drop capabilities, you don't 
need to worry about these details or read any further. If you 
want to know how TShel 1 DropPanel works, read on: 

The actual storage of the published properties Accepting 
and OnDropFi 1 es is in the private section of TShel 1 DropPanel, in 
class variables named FAccepting (a 
Boolean) and FOnDropFi 1 es (a 
TDropFi 1 esEvent). This separation is 
only logical in the case of OnDropFi les. 
The definition of this property. 


The ZylNDEX Toolkit 
High-level Application 
Programming Interface 
(HAPI) is specially 
designed for easy, fast 
implementation. Ideal 
for use with popular 
high-level authoring 
environments such as 
Visual Basic. 

ZylNDEX is the top- 
rated text retrieval 
application, and has led 
the market since 1984. 
Now, your application 
can take advantage of 
advanced full-text 
retrieval technology 
from ZyLAB. 


Query Constructs: 

• word 

• phrase 

• wildcards 

• proximity 

• delimited search 

• quorum 

• file name 

• file date 

• numeric range 

• Boolean operators 

• unrestricted nest 

• concepts 

• field search 

• progressive search 

Fuzzy Searching 

Overcomes ambiguities 
such as misspellings 
that can result from 
OCR limitations. 

Pricing 

Standard Toolkit:$3995 
Fuzzy Search Version:$4995 

Windows, NT and DOS 
versions available. 


a division of ZyCO international 
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property OnDropFi1es : TDropFi1esEvent 
read FOnDropFi les write FOnDropFiles; 

indicates that when it is read or written, 
this property accesses FOnDropFi 1 es 
directly. 

Accepting, on the other hand, is 
defined as follows: 

property Accepting : Boolean 

read FAccepting write SetAccepting; 

When it is read. Accepting simply 
returns the value in FAccepti ng, but the 
function SetAccepti ng () is called to 
write to the value. This feature of 
Delphi allows a property assignment or 
dereference to have specified side 
effects. In the case of TShel 1 DropPanel, 
changing the value of Accepting also 
triggers a call to DragAcceptFi 1 es (), the 
Windows API function that tells the 
system whether the component is 
accepting dropped files or not. 
SetAccepting( ) first verifies that the 
new parameter is different from the 
current value of FAccepti ng, in order to 
avoid an unneccesary and time-con¬ 
suming API call. If the call means a 
change in the Accepting state, 
SetAccepting() sets FAccepting accord¬ 
ingly and then calls DragAcceptFi 1 es(). 
(The parameter Handle is the Windows 
handle of the component, by the way. It 
comes from TWinComponent, a distant 
ancestor of TShel 1 DropPanel.) 

After a window notifies Windows 
that it can accept dropped files, 
Windows notifies that window that 
files have been dropped by sending it a 
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MILLER FREEMAN SOFTWARE DEVELOPMENT GROUP 


EP R&D BOOK NEWS 


The Miller Freeman Software Development Group welcomes you to the first 
issue of R&D Book News, the newsletter for programmers working in C and 
C++, embedded systems, Windows, UNIX, and system administration. 

Here you’ll find the best-selling books for all your technical information 
needs. Drawing on the editorial expertise of Miller Freeman’s magazines-Dr. 


Dobb’s Journal, Software Development, Microsoft Systems Journal, C/C++ 
Users Journal, Windows Developers Journal, and Sys Admin- these resources 
bring you solutions for success. All books are 100% guaranteed; if not com¬ 
pletely satisfied, simply return your order within 15 days for a complete refund. 
If you have any questions or comments, please let us hear from you. 



Building 
Windows 
Help Files 

By Keith E. Bugg 

The nuts and bolts of 
using Microsoft Windows 
Help Applications 


Every Windows application needs effective Win- 
Help. This book is a concise programmer’s refer¬ 
ence for developing the necessary files and making 
them work together. Author Keith Bugg explains 
clearly how to: 

• Organize Help 

• Tie Help to an application 

• Use WinHelp macros 

• Design and manage WinHelp projects 

• Assess the various commercial authoring tools 

Building Windows Help Files gives succinct 

explanations for creating Project files and Topic 
files. The Project file tells the Windows Help com¬ 
piler which Topic files to use, and how to intercon¬ 
nect them. Topic files are Rich Text Format (RTF) 
files containing the text for help messages and 
pointers to other components that the Help appli¬ 
cation will present, such as graphics files or sound 
files. The Topic files also contain formatting 
instructions for searching and identifying pieces of 
text as hotspots for hypertext jumps. 

Plus-this unique book describes how WinHelp 
displays graphics, and the five bitmap formats it 
can read. 

Keith Bugg is a principal of TriStar Systems Inc., 
a consulting firm specializing in Windows and C 
and C++ applications and training. 

280 pages, 7x9, includes 3-1/2” disk, 1995, ISBN 0-13- 
520883-1, Product Code X04, US$29.95 

CONTENTS 

1 Help and WinHelp: An Overview 

2 The Help Project File: WinHelp’s Idea of Make 

3 The RTF Files: Keepers of the Data 

4 Building Help Files: Start Your Engines 

5 The WinHelp Macros: Stepping on the Gas 

6 Enhancing and Extending WinHelp: High Octane 

7 Accessing WinHelp from a Windows Program 

8 Magic Numbers and Names: Rough Terrain 

9 Help Authoring Tools 

10 Help Authoring Guidelines 

11 Designing and Managing Help Projects 

Appendices: Error Message Categories; Compiler 

Token; Baggage File Function; Glossary 



Programming 
Discrete 
Simulations 

Tools for Modeling the 
Real World 

By Moshe A. Pollatschek 

Bridges the gap between 
understanding statistical 
principles and solving prac¬ 
tical modeling problems 

This practical book and accompanying disk provide a 
set of tools for writing discrete simulations-programs 
that use statistical computer models to understand 
scheduling activities too complex for direct analysis. 

Pollatschek explores the interaction between 
programming methods and statistical analysis, and 
demonstrates the interactions between program¬ 
ming considerations and mathematical algorithms. 
Mathematical explanations are straightforward yet 
introduce sophisticated concepts, such as sample 
path and bootstrapping in statistics. 

This book breaks new ground in explaining the 
practical implications of the outlying tail of a dis¬ 
tribution and the problems of finite maxima for the 
range of a variable. Part 1 establishes the statistical 
principles used for discrete event simulation. Part II 
describes all the routines of the Simulation Sub¬ 
routine Set-a library of functions useful for build¬ 
ing simulations. Part III provides 15 example simu¬ 
lations ranging from simple telephone queue sched¬ 
uling to a complex assembly task involving parts 
scheduling and component matching. 

Dr. Moshe A. Pollatschek teaches operation 
research and consults on using computer simula¬ 
tion for planning and decision support 
350 pages, 7x9, includes 3-1/2” disk, December 1995, 
ISBN 0-13-234584-6, Product Code X01, US$39.95 

CONTENTS 

Part I: Principles 

1. Introduction; 2. Modeling Random Phenomena; 

3. Statistical Distributions; 4. Modeling Processes; 

5. Statistical Techniques; 6 . Random Variate 
Generators; 7. Implementation Details 
Part II: Manual (coded in C; explains all functions) 

Part III: Examples (coded in C; 15 simulations of 
increasing complexity and 24 sample problems) 
Appendices: Language Comparisons with C-Basic, For¬ 
tran, Pascal; Simulation Software Vendors; Global 
Variables of SSS; Structures of SSS; Summary of 
SSS Routines; Glossary 


Understanding 
Self-Similar 
Fractals 


A Graphical Guide to 
the Curves of Nature 

By Roger T. Stevens 

Allows you to create your 
own fractals using the 
L-systems language 


Ntty 


With Understanding Self-Similar Frac¬ 
tals, beginners get a hands-on lesson in self-similar 
geometries and algorithms, while experts get a fast 
and simple tool for fine-tuning fractals and graph¬ 
ic artists get a method for creating naturalistic 
images by programming. 

Author Roger Stevens describes how the L-sys¬ 
tems language-developed by biologist Aristid Lin- 
denmayer for describing plants—is especially useful 
for defining self-similar fractal curves. Based on 
using this language, the book explains how to use 
fractals to depict naturalistic surfaces such as trees 
and bushes, and how to create entire scenes with 
collections of fractal images. 

Complete programming code in C is provided 
on the companion disk for generating and manip¬ 
ulating these graphic curves and scenes, and saving 
them in .PCX files for redisplay or printing. 

Roger T. Stevens has written several books on 
various aspects of graphics programming. 

400 pages, 7x9, includes 3-1/2” disk, 1995, ISBN 0-13- 
436676-X, Product Code V75, US$39.95 

CONTENTS 

1 Introduction 

2 Monster Curves and Their Mathematical Impli¬ 
cations 

3 The L-Systems Language 

4 Using the L-Systems Program 

5 Fractal Dimension and What It Means 

6 The Snowflake and Other Koch Curves 

7 Plane Filling Curves 

8 Node Rewriting: The Hilbert Curve 

9 Sierpinski Triangles, Boxes, and Islands 

10 Tiling with Fractal Curves 

11 Generators with Line Segments of Different 
Lengths 

12 Trees and Bushes 

13 Leaves and Flowers 

14 Random Fractal Curves 

15 Delay in Branch Development 

16 Creating Scenes 

17 Viewing and Printing Fractal Graphics Files 
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C & C + + PROGRAMMING 


Optimizing C with 
Assembly Code 

Secret Rules of Assembler 

By Peter Gulutzan and Trudy Pelzer 

For programmers who know how to profile 
programs and provide efficient processing-hut 
who want the last iota of speed in execution 


wO Secret Rules ol Assembler 

OPTIMIZING 

V ''with 
assembly 


This book and accompanying disk 
show you how to make C programs 
run faster by strategically inserting 
brief in-line assembly code. These 
assembly routines can streamline 
processing by 15% to 50%. 

The book evaluates and compares 
the optimizers of the three most pop¬ 
ular C compilers: Borland C++, 
Microsoft C++, and Symantec C++. 
They are used as test compilers 
throughout but the processing rules 
focus on methods common to all C 
compilers. 

The disk has function replace¬ 
ments that make programs run 
faster, and provides the utility 
TACHO.EXE-a “tachometer" that 
assesses the cycle times of executable 
program files. 

Though aimed at MS-DOS and 
Windows 3.x running on 486s, many 
of the improvements are relevant for 


OS/2 and other 32-bit systems. Most 
are useful for 386s; those which are 
not, are identified. 

Peter Gulutzan and Trudy Pelzer 
are the principals of Ocelot Comput¬ 
er Services Inc. in Edmonton, Alber¬ 
ta, Canada. They also co-authored 
Optimizing SQL. 

432 pages, 7x9, includes 3-1/2” disk, 
1995, ISBN 0-13-234576-5, Product Code 
V79, US$29.95 


Contents 

I) An Assembler Primer • 2) Basic 
Arithmetic and Logic Operations • 

3) Jumps-The Assembler GOTO • 

4) Bit Shifts • 5) Other Instructions • 

6) Manipulating the Stack • 

7) Multiplication Operations • 

8) Division Operations • 9) Handling 
Intel Strings • 10) Optimizing a Sort • 

II) C String Functions • 12) Counting 
Cycles with TACHO.EXE • Appendices 


MS-DOS System Programming 

3rd Edition • Edited by David Burki and Robert Ward 


For programmers who 
have mastered their craft 
and now seek technical 
information to support 
advanced applications in a 
PC environment, MS-DOS 
System Programming now 
covers MS-DOS V5 and V6. 

Three times larger than the 
second, this fully updated and 
expanded edition explains core DOS 
processes useful for systems pro¬ 
grammers writing sophisticated 
applications. 

Revised chapters explain event 
timing, accessing the global environ¬ 
ment, TSRs, critical error handling, 
modifying the DOS boot, interrupt- 
driven serial I/O, interfacing to the 



floppy disk controller, and 
writing device drivers. 
New chapters cover pro¬ 
gramming serial commu¬ 
nications, the floating 
point coprocessor, the PC 
speaker, CD-ROM drivers, 
Direct Memory Access, 
VGA graphics animation, 
self-loading device drivers, handling 
DOS file handle limits, and the Load- 
all instruction. 

David Burki is a programmer/ 
analyst for PDA, Inc. Robert Ward is 
a well-known technical lecturer and 
the author of Debugging C. 

830 pages, 7x9, includes 3-1/2” disk, 
1994, ISBN 0-13-207382-X, Product Code 
V36, US$39.95 


Optimizing SQL 

Embedded SQL in C 

By Peter Gulutzan and Trudy Pelzer 

For data processing professionals converting 
to C and database developers working in C 
who need in-depth information on how 
best to interface with SQL 



■5E5 Embedded SQL in C 


This book and companion disk 
explain Structured Query Language 
(SQL) programming from the rudi¬ 
ments to the subtleties that even 
some experts may not know. The 
programming explanations are 
generic, detailing the best ways to 
interface with any SQL product that 
conforms to the ANSI standard. 

Key topics covered include how to 
embed SQL in C; how to use an 
application programming interface 
(API) with Microsoft’s Open Data¬ 
base Connectivity interface (ODBC) 
as the example API; strategies for 
portable programs and high perfor¬ 
mance; and thorough summaries of 
SQL commands. 

The companion disk includes all 
programs in the book plus tools, 
libraries, and documentation files 
from the authors’ own SQL database 
management system, “Ocelot.” It 
runs on any PC with DOS or Win¬ 


dows; the libraries are MS-DOS 
based but can run under Microsoft 
Windows without full Windows 
graphics capabilities. 

Peter Gulutzan and Trudy Pelzer 
are the principals of Ocelot Comput¬ 
er Services Inc. in Edmonton, Alber¬ 
ta, Canada. They also co-authored 
Optimizing C with Assembly Code. 
230 pages, 7x9, includes 3-1/2” disk, 
1994, ISBN 0-13-100215-5, Product Code 
V01, US$34.95 

Contents 

1) Why a Book on SQL and C? 

2) What SQL Statements Mean 

3) Embedded Static SQL 

4) Embedded Dynamic SQL 

5) ODBC (Microsoft's Open Database 
Connectivity Standard) 

6) Indexing for Performance 

7) Optimizing Rules of Thumb 

8) Beneath the Covers (How Struc¬ 
tured Query Databases Operate) 

Appendix 


Image Processing in C 

Analyzing and Enhancing Digital Images 

By Dwayne Phillips 
This book and companion 
disk form a complete tutor¬ 
ial for programmers seek¬ 
ing tools for image process- 
ing-from the basics to 
advanced techniques. With 
C code based on articles 
published in The C Users 
Journal, you get basic con¬ 



cepts in words and figures, image 
processing results in photographs, 
and the means to implement the 
operations in C. 

Three new chapters present an 
introduction to the entire system, a 
set of routines for Boolean opera¬ 
tions on images, and a batch system 
for performing off-line processing. 


Because the articles were 
written for the TIFF 5.0 
specification, the entire 
system has been updated 
to comply with TIFF 6.0. 
The text and accompany¬ 
ing source code provide 
working edge detectors, 
filters and histogram 


equalizers, I/O routines, and display 
and print procedures that are ready 
to use or to be modified as needed. 

Dwayne Phillips is a computer 
and electronics engineer with the 
U.S. Department of Defense. 

720 pages, 7x9, includes 3-1/2” disk, 
1994, ISBN 0-13-104548-2, Product Code 
T60C, US$39.95 


Object-Oriented Software Engineering 

By Steve Halladay and Michael Wiebel 
Demonstrates object-oriented principles (OOP) for 
each phase of developmenL Describing a method¬ 
ology that combines the strength of OOP with a 
pragmatic process, the book shows you how to 
engineer applications to minimize costs, manage all 
six phases of the software life cycle, and use recur¬ 
sion in the object-creation process. 

358 pages, 7 x 9,1993, ISBN 0-13-034489-3, Product Code 
T37, US$29.95 


Graphics Programming and Animation 

By Peder jungck 

Describes the inner workings of the ProGraphx Tool¬ 
box, widely used in video game developmenL 
Explains how to program an EGA/VGA adapter 
using assembly language, allowing the Toolbox to 
work with C and Pascal. Video modes and basic 
graphics routines are detailed, with examples of core 
functions-with 170+ program files on disk. 

325 pages, 7x9, includes 3-1/2” disk, 1994, ISBN 0-13- 
088527-4, Product Code T86C, US$49.95 


Illustrated C • By Leor Zolman 
Explore the construction of several different appli¬ 
cations, from start to finish. Through a focus on 
building useful, practical programs, this book and 
disk give you the “why and how” of application 
design and development. Each program is thor¬ 
oughly annotated in a clear, readable style. Provides 
all source code for the applications programs, which 
work under both DOS and UNIX/Xenix. 

315 pages, 7x9, includes 3-1/2” disk, 1991, ISBN 0-13- 
031345-9, Product Code W36, US39.95 
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EMBEDDED SYSTEMS PROGRAMMING 


|mC/OS 

The Real Time Kernel 

By Jean J. Labrosse 

A complete preemptive multitasking operating 
system with performance comparable to many 
commercial kernels 



This book explains the design and 
implementation of |iC/OS (pro¬ 
nounced “MicroC/OS’Y the Micro- 
Controller Operating System-a port¬ 
able, ROMable, preemptive, real-time, 
multitasking kernel for microproces¬ 
sors. The system is written in C with 
assembly language code for the target 
microprocessor kept to a minimum. It 
can be ported to any microprocessor 
that provides a stack pointer and 
allows the CPU registers to be pushed 
onto and popped from the stack. The 
C compiler must be ANSI compatible 
and provide in line assembly or lan¬ 
guage extensions that allow you to 
enable and disable interrupts. The sys¬ 
tem can manage up to 63 tasks, with 
performance comparable to many 
commercially available kernels. 

The text explains the fundamentals 
of multitasking real-time systems, 
details the design decisions of this ker¬ 
nel, and includes a user’s manual for 
the system. Appendices provide com¬ 
plete code for the system, a port for 
the Intel 80186/80188 chip, a survey 
of real-time kernel manufacturers, and 


references of technical literature on 
real-time and embedded systems. 

Jean J. Labrosse has been devel¬ 
oping real-time software for more 
than 10 years on a wide range of 
microprocessors, and currently 
designs control software for large 
industrial reciprocating engines. 

266 pages, 8 x 10, includes 3-1/2” disk, 
1992, ISBN 0-13-242967-5, Product Code 
W62C, US$49.95 

Contents 

1 Real-Time Concepts 

2 Kernel Structure 

3 interrupt Processing 

4 Communication, Synchronization, & 
Coordination 

5 Initialization & Configuration 

6 Reference Manual and Timing Refer¬ 
ence 

7 Examples 

Appendices: A) pC/OS Microprocessor 
Independent Source Code • B) 
80186/80188 Microprocessor Specific 
Source Code • C) Software Develop¬ 
ment Conventions • D) LISTC & 
HPLISTC • E) TO • F) Real-Time Ker¬ 
nel Manufacturers • G) Bibliography 
• H) Companion Disk 


Embedded Systems 
Building Blocks 

Complete and Ready-to-Use Modules in C 

By Jean J. Labrosse 

Basic, reusable real-time system modules 
and how to use and modify them 



Time to market is becoming as impor¬ 
tant as cost control in gaining compet¬ 
itive advantage. The portable, ready-to- 
use code this book and companion 
disk provide can save you time and 
money in system development and 
shorten your time to market 

Certain pieces are common to 
most systems: a display, a keypad, 
various analog and discrete inputs 
and outputs, communications with 
host computers, event timing, and 
keeping track of date and time. Here 
Labrosse gives you basic building 
blocks for all these processes, free¬ 
ing you to work on the fun parts of 
your designs. By providing some of 
the peripheral functions, this book 
and disk let you put your energy 
into the tangible specifics of each 
unique system. 

Designed for embedded system 
programmers, consultants and stu¬ 
dents, the book assumes you know C 
programming language and a mini¬ 
mum of assembly language program¬ 
ming and have some knowledge of 


microprocessors and basic electronics. 

Jean J. Labrosse has been devel¬ 
oping real-time software for more 
than 10 years on a wide range of 
microprocessors, and currently 
designs control software for large 
industrial reciprocating engines. 

600 pages, 8 x 10, includes 3-1/2” disk, 
1995, ISBN 0-13-359779-2, Product Code 
V74, US$39.95 

Contents 

1 Sample Code 

2 Real-Time Concepts 

3 Keyboards 

4 LED Displays 

5 LCD Character Modules 

6 Time-of-Day Clock 

7 Timers 

8 Discrete I/Os 

9 Fixed and Floating-Point Math 

10 Analog l/Os 

11 Asynchronous Serial Communica¬ 
tions 

Appendices A) pC/OS, the Real-Time 
Kernel • B) Programming Conven¬ 
tions • C) Glossary • D) LISTC and 
HPLISTC - E) TO - F) Data Sheets • 
G) Companion Diskette 
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WINDOWS PROGRAMMING 


Writing Windows VxDS and 
Device Drivers 

By Karen Hazzah 

Discover the alternatives for interfacing 
Windows applications to hardware-from 
the simplest Dynamic Link Library (DLL) to 
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WM_DROPFIL.ES message. TShel 1 DropPanel defines a special 
"message-handling method," WMDropFi 1 es( ), to deal with this 
message. WMDropFi 1 es () is defined as follows: 

procedure WMDropFi1es( 

var Msg : TWMDropFi 1 es); 
message WM_DR0PFILES; 

The Delphi component library's message-dispatching system 
will ensure that this method is called in response to the 
WM_DR0P FI LES message. The parameter type, TWMDropFi 1 es, is a 
sort of message-cracker defined in messages.dcu to simplify 
decoding the message parameters. Even though WM_DR0P FI LES 
has no known ancestral procedure, Delphi allows a call to the 
inherited message-handler. Delphi's message-handler method 
system is unique: you invoke the ancestral procedure simply 
by using the keyword inherited, without specifying the 
method name or parameters. The library sees to it that the call 
is dispatched or handled correctly. After that business, 
WM_DR0PFI LES calls the private method DoDropFi 1 es(). 

DoDropFilest ) is the meatiest method in this component. 
This procedure first ensures that the drop occurred in the 
client area of the TShel 1 DropPanel . It then creates a temporary 
TStringList to hold the list of dropped files. A common error 
in using Delphi components like TStringList derives from a 
misunderstanding of what it means to declare a variable of a 
TObject-descended class. It is important to understand that 
the declaration 
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ates .hip files from source code com¬ 
ments. A filter that locates source 
code that may work on Win95 but not 
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on OLE compound files. 


Listing 1 continued 


end; 

finally 

DragFinish(Msg.Drop); 

end; 

end; 

procedure TShel1DropPanel.WMDestroy(var Msg : TWMNoParams); 
begin 

inherited; 

Accepting False; 

end; 

end. 

{ End of File } 


var IstFiles : TStringList; 

doesn't create a TStri ngLi st object! What it creates is rather a 
reference to a TStringList object. That is, a variable that can 
hold a TStringLi st. The actual list is only created when one of 
its constructors is called. DoDropFi lest) accomplishes this 
with the line 

IstFiles :- TStringList.Create; 

DoDropFi 1 es () then calls the Windows API function 
DragQueryFi 1 es() to determine the number of files that were 
dropped on the TShel 1 DropPanel . That same function is then 
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Figure 1 Demonstrating TShellDropPanel 


called in a loop to fetch the actual names of the files, which are 
added to the string list. When all the file names have been 
retrieved, a call is made to DropFilesO, which eventually 
leads to the OnDropFiles event handler. 

Because DoDropFi 1 es( ) can't predict what might happen 
during the call to the OnDropFilesO event handler, it practices 
some defensive techniques. Two try...finally blocks sur¬ 
round blocks of the DoDropFi 1 es () method. These blocks 
ensure that even if an exception occurs within the block. 
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Listing 2 sdrptest.dpr — Project source for 
demo program 


program Sdrptest; 

uses 
Forms, 

Mainform in 'MAINFORM.PAS' {FormMain}; 
{$ R *.RES} 
begin 

Application.CreateFormtTFormMain, FormMain); 
Application.Run: 
end. 

/* End of File */ 


things will be cleaned up appropriately. The first block makes 
sure the Windows API function DragFinishO is called, so that 
the system will release resources allocated as part of the drag- 
and-drop interface. The inner block sees to it that memory 
allocated for the TStri ngLi st is freed. 

The last procedure in TShellDropPanel is another message¬ 
handling method. WMDestroyO responds to the WM_DESTROY() 
message by setting the TShel 1 DropPanel 's Accept! ng property 
to False. Recall that this leads to a call to DragAcceptFi 1 es(), 
telling the system that the window will no longer accept files. 
You might think this could be more efficiently accomplished 
in a TShellDropPanel destructor. It seemed so to me, anyway, 
until I realized that that was way too late; the window handle 
associated with the component is destroyed long before the 
component is. 

Using TShellDropPanel 

I wrote a small program called sdrptest.exe (see Figure 1) 
to show how to use TShel 1 DropPanel. sdrptest.dpr (Listing 2) 
contains the project source; mainform.pas (Listing 3) is the 
source code for the form; and mainform.dfm (Listing 4) con¬ 
tains the text version of the form description. (The code disk 
— see Table of Contents for availability — includes the binary 
version of mai nform.dfm.) The demo program's main window 
has a checkbox labeled "Accept Dropped Files" at the top, and 
a panel containing a list box below. You can click the checkbox 
and then drag files from the File Manager and drop them on 
the listbox. The program will display in the listbox the names 
of the files you dropped. 

mai nform. pas (Listing 3) shows that the demonstration pro¬ 
gram code consists of a single form, FormMain, that holds a 
TCheckBox and a TShel 1 DropPanel . The TShel 1 DropPanel in turn 
contains a TListBox. The TListBox's Align property is set to 
alClient, so that it completely fills the client area of the 
TShellDropPanel. In action, this gives the impression that it is 
the listbox that is accepting the dropped files. 

Being a simple demonstration, FormMain has only four pro¬ 
cedures, each consisting of a single line. SetAccepti ng( ) is a 
private procedure that sets the TShel 1 DropPanel 's Accepting 
property to match the state of the TCheckBox — True if the box 
is checked, False if it isn't. FormCreateO is called when the 
form is first created, and CheckBoxlCl ick( ) when the 
TCheckBox is clicked. Both procedures just call SetAccepti ng() 
to keep the states of TCheckBox and TShel 1 DropPanel synchro- 
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nized. Finally, Shel 1 DropPanel IDropFi 1 es( ) is the 
TShel 1 DropPanel's OnFi leDrop method. This procedure sets the 
TLi stBox's Items property to the list of files. 

Summary 

Using a component-based programming language like 
Delphi requires a broadening of your perspective. Writing 
reusable code is still a goal, but there are more levels on which 
the code can be reused. To produce the most useful Delphi 
components, it helps to think of three potential users: the 
application builder, who will drop your component on his 
form without a care for how it works; the component sub¬ 
classes who will derive a new component from yours, chang¬ 
ing or modifying its properties; and, finally, you, who must 
make it all work. □ 


Listing 3 mainform.pas — Source for main 
form of demo 


unit Mainform; 

interface 

uses 

SysUtils, WinTypes, WinProcs, Messages, Classes, Graphics, 
Controls, Forms, Dialogs, StdCtrls, ExtCtrls, ShellDrp; 

type 

TFormMain - class(TForm) 

Shel1DropPanel1: TShellDropPanel; 

ListBoxl: TListBox; 

CheckBoxl: TCheckBox; 

procedure CheckBoxlClick(Sender: TObject); 
procedure FormCreatetSender: TObject); 
procedure ShellDropPanellDropFiles(Sender: TObject; 
Files; TStringList; Location; TPoint); 
private 

procedure SetAccepting; 
end; 

var 

FormMain: TFormMain; 
implementation 
{$R *.DFM) 

procedure TFormMain.SetAccepting; 
begin 

ShellDropPaneil.Accepting := CheckBoxl.Checked; 
end; 

procedure TFormMain.CheckBoxlClick(Sender: TObject); 
begin 

SetAccepting; 
end; 

procedure TFormMain.FormCreatetSender: TObject); 
begin 

SetAccepting; 
end; 

procedure TFormMain.ShellDropPanelIDropFilest 
Sender; TObject; Files; TStringList; Location: TPoint); 
begin 

ListBoxl.Items ;- Files; 
end; 

end. 

{ End of File } 


Listing 4 mainform.dfm — Text definition 
for main form of demo 


object FormMain: TFormMain 
Left - 202 
Top - 105 
Width - 435 
Height - 300 

Caption - ’TShellDropPanel Test' 

Font.Color - cl Black 

Font.Height - -11 

Font.Name - 'MS Sans Serif' 

Font.Style - [fsBold] 

PixelsPerlnch - 96 
OnCreate - FormCreate 
TextHeight - 13 

object ShellDropPaneil: TShellDropPanel 
Left - 4 
Top - 32 
Width - 421 
Height - 237 
TabOrder - 0 
Accepting - False 

OnDropFiles - ShellDropPanelIDropFiles 
object ListBoxl: TListBox 
Left - 1 
Top - 1 
Width - 419 
Height - 235 
Align - alClient 
ItemHeight - 13 
TabOrder - 0 
end 
end 

object CheckBoxl: TCheckBox 
Left - 8 
Top - 8 
Width - 149 
Height - 17 

Caption - '&Accept Dropped Files' 
TabOrder - 1 

OnClick - CheckBoxlClick 
end 
end 
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Edited by Leor Zolman 


Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they should! 
You'll receive at least $50 for each tip 
that we print. 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
North Reading, MA 01864 


A C++ Class for Microsecond Timer Services 


Trevor Harmon 
73771.3307@compuserve.com 


Programmers of the Win32 API have two options for timer services. The typical 
solution is to call SetTimer (), which sends the WM_TIMER message at specific intervals. 
But SetTimerO has a resolution of only 50 microseconds to 100 microseconds, 
depending on the speed of the computer. The other option is to create a multimedia 
timer. Calling timeBeginPeriodO causes Win32 to generate a timer service with a res¬ 
olution as low as 20 microseconds. 

I recently discovered a third option — one that brings the resolution all the way 
down to 20 microseconds. The little-used but very powerful 
QueryPerformanceCounterO is the key to this high-frequency timer service. In con¬ 
junction with its companion, QueryPerformanceFrequencyf ), programmers can call 
this function twice to determine the number of microseconds that have elapsed 
between the two calls. 

This method isn't as convenient as SetTimerO or timeBeginPeriodO, both of 
which automatically send a window message or call a function at each period. 
Instead, the programmer must continually poll the counter to determine the number 
of microseconds that have elapsed. Despite this compromise, 
QueryPerformanceCounterO is still very useful. You could, for example, create a 
benchmark application that detects the number of microseconds needed for certain 
tasks. Or you could create a high-resolution SI eep () function that stops execution of 
your program for a given number of microseconds. (Win32's SI eep () uses millisec¬ 
onds.) I'll let your imagination come up with some other possibilities. 

To make things easier, I wrapped QueryPerformanceCountert ) in a C++ class. 
Called microTimer, this class has only two member functions: StartO and 
GetEl apsedTime( ). The header file is in microtim. hpp (Listing 1), the implementation 
is in microtim.cpp (Listing 2), and a test driver is in demonstr.cpp (Listing 3). The 
whole package, including the .mak file, is on disk as microtim.zip (see Table of 
Contents for availability). The StartO function simply resets the counter, and the 
GetEl apsedTime( ) function returns the number of microseconds that have elapsed 
since StartO was last called. 

As expected, microTimer's constructor initializes its private variables. But rather 
than setting the Frequency variable to zero, it calls QueryPerformanceFrequencyt ) to 
get the proper value. Because the frequency is constant for each system, mi croTimer 
initializes Frequency in the constructor to reduce overhead in GetEl apsedTi me (). 

(text continued on page 38) 



Leor Zolman is a consultant specializing in C/C++ programming training, an instruc¬ 
tor on UNIX topics for Boston University's Center for Information Technology, and 
"Tech Tips" editor for Windows Developer's Journal. His book, Illustrated C, was 
published in 1992. He may be contacted at 74 Marblehead St., North Reading, MA 
01864. Internet address: leor@bdsoft.com. 
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Listing 1 microtim.hpp 


Listing 3 demonstr.cpp — Test driver for 
microtim class 

#1fndef MICROTIMER H 
#define MICROTIMERJ 

//include <windows.h> 

//include <1 argeint.h> 

class microTimer { 
public: 

microTimert); 
void Start!); 

DWORD GetElapsedTimel); 
private: 

LARGE INTEGER StartTime, Frequency; 

1; 


// Demonstration program for the microTimer class. 

//include <windows.h> 

//include <windowsx.h> 

//include "microTim.hpp" 

HINSTANCE hlnstance; 

void 

microSleep(DWORD microsecs) 

{ 

microTimer timer; 

timer.Start () ; 

while (timer.GetElapsedTimeO < microsecs); 

} 

/fendif 

//End of File 


void 

TestMicroSleep(HWND hwnd) 

{ 

microTimer timer; 



timer.StartO; 


microSleep(500); 

DWORD dwElapsed - timer.GetElapsedTimeC ) ; 

Listing 2 microtim.cpp 


char mes$age[50]; 

wsprintf(message, "We slept for %lu microseconds.", dwElapsed); 
MessageBox(hwnd, message, "Sleep", MB OK | MB IC0NINF0RMATI0N); 

} 

void 

DoBenchmark(HWND hwnd) 

{ 

1 nt b; 

microTimer timer; 

RECT rc; 

HDC hdc; 

HBRUSH hBrush; 

DWORD dwElapsed; 

SetRect(&rc, 220, 10, 520, 320); 

// microTimer.cpp: A C++ class for microsecond timer services. 

// Works only under Visual C++ 

// Written by Trevor Harmon, 73771.3307@compuserve.com 

//include "microTim.hpp" 

microTimer::microTimer() 

{ 

StartTime.LowPart - 0; 

StartTime.HighPart = 0; 


QueryPerformanceFrequency(&Frequency); 

} 


hdc = GetDC(hwnd); 


timer.Start( ) ; 

void 

microTimer::Start() 

{ 

QueryPerformanceCounterUStartTime); 

} 


for (b - 0; b < 256; b++) 

{ 

hBrush - CreateSolidBrush(RGB(128, 0, b )) ; 

FillRect ( hdc, &rc, hBrush); 

DeleteBrush ( hBrush ) ; 

} 


dwElapsed - timer.GetElapsedTimeO; 

DWORD 

microTimer::GetElapsedTimel) 

{ 

LARGEJNTEGER Elapsed, Remainder: 


ReleaseDC(hwnd, hdc); 

char message[200]; 

wsprintf(message, "FillRecto took %lu microseconds.", dwElapsed); 
MessageBox(hwnd, message, "Benchmark", MB_0K | MBJC0NINF0RMATI0N): 

} 

QueryPerformanceCounterUEl apsed); 


HWND hwndSleepBtn, hwndBenchmarkBtn; 

// Determine the number of clock ticks that have elapsed 
// by subtracting the start time from the elapsed time. 

Elapsed - LargelntegerSubtractCElapsed, StartTime); 

// Because we're dealing with integers, multiply the 
// elapsed time by 1000000 before dividing it. This will 
// prevent problems in getting a fractional number. 

Elapsed - ExtendedlntegerMultiplyCElapsed, 1000000); 


LRESULT WINAPI MainWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM IParam) 

{ 

switch (message) 

{ 

case WM_CREATE: 

hwndSl eepBtn - CreateWindowC'BUTTON", "Test microSleepO", 

WS VISIBLE | WS CHILD. 10. 

10, 200, 50, hwnd, NULL, 
hlnstance, NULL); 

// Divide the clock ticks by the frequency to determine 
// the number of microseconds that have elapsed. 

Elapsed = LargelntegerDivl de(El apsed, Frequency, ^Remainder); 


hwndBenchmarkBtn = CreateWindowC'BUTTON", "Benchmark 

test", WS VISIBLE | WS CHILD, 

10, 70, 200, 50, hwnd, NULL, 
hlnstance, NULL); 

return Elapsed.LowPart; 

} 

//End of File 


break; 


case WM.C0MMAND: 



if ( (HWND)lParam — hwndSleepBtn ) 

TestMicroSleep(hwnd); 
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Listing 3 continued 


else 


i 

hlnstance - hlnst; 

if ( (HWND)lParam — hwndBenchmarkBtn ) 


DoBenchinark(hwnd); 

HWND hwnd; 

)/ 


break; 

hwnd - CreateWi ndow( 

"DemoWindow", 

case WM QUIT: 

"microTimer Demonstration", 

WS OVERLAPPEDWINDOW, 

case WM DESTROY: 

CW USEDEFAULT, 

PostQuitMessage(O): 

CW USEDEFAULT, 

break: 

CW USEDEFAULT, 

} 

CW USEDEFAULT, 

return DefWindowProc(hwnd, message, wParam, 1Param): 

NULL, 

NULL. 

} 

hlnst, 

int WINAPI WinMain(HINSTANCE hlnst, HINSTANCE hPrevInst, LPSTR lpCmdLine, 

NULL 

); 

int nCmdShow) 


i 

ShowHindowOwnd, nCmdShow | SW SHOWMAXIMIZED); 

if (!hPrevInst) 

UpdateWindow(hwnd); 

WNDCLASS wc; 

MSG msg; 

wc.style - CS HREDRAW | CS VREDRAW; 

while ( GetMessageUmsg, NULL, 0, 0) ) 

wc.lpfnWndProc - MainWndProc; 

i 

wc.cbClsExtra = 0; 

TranslateMessage(&msg); 

wc.cbWndExtra = 0; 

DispatchMessage(&msg); 

wc.hlnstance - hlnst: 

) 

wc.hlcon - LoadIcon(NULL, IDI APPLICATION): 


wc.hCursor = LoadCursor(NULL, IDC ARROW); 

return (msg.wParam); 

wc.hbrBackground - (HBRUSH)(COLOR_BTNFACE + 1): 

} 

wc.lpszMenuName = NULL; 

//End of File 

wc.1pszClassName - "DemoWindow"; 

RegisterClass(&wc); 

} 
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My implementation of mi croTimer 
has a portability problem; it works only 
under Microsoft Visual C++. 
QueryPerformanceFrequencyl ) uses 
Win32's LARGE_I NTEGER structure, and 
Visual C++ is the only compiler I can 
find that provides division operations 
on LARGE_I NTEGERs. If necessary, you 
could get around this problem by 
downloading Michael Potter's CBi gill NT 
class from the Win32 forum on 
CompuServe. [For a discussion of 64-bit 
ints, see Potter's "64-Bit Ints for Huge 
Files and Volumes," WD] Oct. 1995.] 

An Improved ASCII 
Encoding Utility 


Terje W. Mathisen 
Hydro Data 
Norsk Hydro 

terje.mathisen@hda.hydro.com 
Bix: terjem@Bix.com 

I just read the very interesting Tech 
Tip ("A Universal ASCII Encoding 
Utility for DOS," by Jim Lawless, Tech 
Tips, April 1995) about how to generate 
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a script file which, when redirected into debug, will regenerate 
a binary file. 

This is a great idea! 

I just wanted to increase the size of files that could be 
encoded and improve the efficiency of the packing, so I wrote 
a slightly different version of this utility. 

I use five characters to store four bytes, using modulo 85 
arithmetic. This reduces the packing overhead from 33 percent 
to 25 percent. 

I also reduced the size of the unpacking program, from 118 
bytes to less than half, 57 bytes. This reduces the size of the 
fixed overhead for the encoding process. 

To minimize the size of the program, I store the bytes in 
reverse order in the script, and use the stack pointer to address 
my buffer. This lets me encode files up to 0xFE80 bytes. 

The decoder loop looks like 


Listing 4 

dbdecode.asm 

; Written by Terje Mathisen, 1995, based upon an idea from 

; Jim Lawless 



.model 

tiny 


.code 



org 

0 

return 

label 

near 


org 

5ch 

maxlen 

db 

? 

datalen 

db 

? 

buffer 

db 

5ch dup (?) 


org 

lOOh 

start: 





this: 

next_block: 

xor 

ax,ax 


xor 

bp,bp 


mov 

bl ,5 

5 input 
chars/4-byte 
output block! 

next_char: 

inc 

si 


xchg 

ax,bp 

Mul old 
value by 85 

mul 

di 


xchg 

ax,bp 


mul 

di 


mov 

cx,256-21h 


add 

cl.[si] 


add 

ax.cx 

and add in 
the current 
char (-21h) 

adc 

bp, dx 


dec 

bl 


jnz 

next_char 


push 

bp 

Save this 
block 

(reverse order!) 

push 

ax 


sub 

bh, 5 

More blocks? 

ja 

next_block 


jmp 

nextjine 

Get next input 
line 

The following notes 

are excerpted 


from some e-mail exchanges sent by 
Terje Mathisen to Jim Lawless, the 
author of the original dbencode utili¬ 
ty published in April 1995. It is grat- 
ifying to see the column inspiring cre¬ 
ative coding such as this. The com¬ 
plete assembly language decoder pro¬ 
gram is shown in dbdecode.asm 
(Listing 4), with the C encoding pro¬ 
gram in dbencode.c (Listing 5). The 
complete package is on the code disk 
as dbencode.zip. —h 


mir simuiMnn risw i 

MM COMPANIES DEPEND ON OUR TOOL FOR MAKING IMPRESSIVE HELP FILELJOfT YOU? 


Join the tens of thousands of satisfied customers 
and get a copy of Help Magician Pro, the full- 
featured stand-alone WYSIWYG Help Authoring 
Tool without the ultimate price! Thousands of 
man hours, customer suggestions, and foresight 
went into creating a product that will make your 
job a breeze in creating online documents and 
help files for WinHelp. Help Magician is a 
proven product with over 3 years market 
presence and is offered by a company celebrating 
its 10th year in business. Now go build some 
help. 
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Actual WYSIWYG editing environment shown here 
with the same compiled WinHelp file. 

Help Magician Pro is a good tool for quickly building 
help files in a graphical environment that also 
allows instant testing. 

Jim Powell, Windows Magazine 

... Certainly for Windows programmers it’s 
indispensable. 

Neil Rubenking, PC Magazine 



Low Cost, Rich in 

* Self-contained WYSIWYG development 
environment simulates WinHelp 

* Easy to use WinHelp Editor with spell 
checker-- does not require Word or RTF 
codes 

* Import document files from Word, Ami 
Pro, or WordPerfect- including bitmaps! 

★ Converts documents to help 

★ Powerful multi-file/multi-author WinHelp 
Project Management™ for team 
development on a network 

★ Simultaneous test mode with live 
hypertext links, browse sequences, and 
back button 

* Easily include multimedia audio, video, 
and animation in your help files 

★ Supports many graphic file formats 

★ Built-in glossary creation 

* Built-in screen capture utility 

* Creates help file shell from Visual Basic 
or Visual C programs 

★ Graphical topic navigator 

★ Fool-proof macro editor guides you in 
creating WinHelp macros 

* Supports ANY Windows development 
language or use it stand-alone 

★ Includes Help Compilers 

★ Free technical support and 30-day 
money-back guarantee 

* Works with Windows 3.x, WFW, 
Windows NT, and Windows 95 

* Corporate SITE licensing available 
(single user license price quoted below) 


The most sneaky trick I imple¬ 
mented, was to let my stack point¬ 
er do double duty, it is also the 
output buffer pointer! :-) 

This forced me to encode all data 
in reversed order: The first five 
characters encode the last 32-bit 
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dword in the input file, with the first character having the 
most significant portion. 

This freed up DI to hold the fixed multiplier (85), which if not 
would have had to stay in ram. 

... the enclosed new version moves the input buffer down to 
the FCB storage area in the PSP (org 05Ch), leaving about 100 
bytes free between the stack pointer and the line input buffer. 

Another sneaky trick is that by loading my program at 
0FF80h, I can terminate it by a relative jump that wraps 
around to address zero! 


breakpoint instead, since that is shorter, and this program is 
always running under debug, anyway.) 

In the final count, I got it down to just 57 bytes, which isn't 
too bad for what it's doing.:-) 

The updated version of dbencode. zip is capable of encoding 
executable files and files larger than 64K. It does this by split¬ 
ting larger files into multiple temporary blocks, each less than 
64K, and then generates a helper batch file, dbtemp. bat, which 
contains the necessary COPY /B command to join them back 
together. To improve the efficiency, I only load the 57-byte 
decoder once, and reuse the same code on each sub-block. 


This removed the need for two more bytes of code to store an 
INT 20 terminate call. (Actually, I used a single-byte INT 3 



to new beta 


Quadbase-SQL 4.0 is ideal for developers who build open 
client/server applications that require a DBMS which 
offers high-performance, robustness, ease-of-use, 
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HIGH-PERFORMANCE 
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HIGHLY SCALABLE 

• small footprint, runs comfortably on 
desktop and laptop machines 
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control over physical storage management 

• on-line backup 

• media recovery' 

EASE-OF-USE 

• easy to install 
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workgroup applications 

CONFORMS TO STANDARDS 

• entiy level ANSI SQL '92 
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Handling Return Key 
Processing in Controls 


V. Ramachandran 
raja@imagine.uunet.in 


When developing controls, you 
sometimes need to do some processing 
whenever the user presses the Return 
key. For example, with a hierarchical 
listbox (similar to the Index window in 
the MSDN CD-ROM), when the user 
hits Return on a collapsed item, it is 
expanded and its children are made vis¬ 
ible. Since this behavior is inherent to 
the control, the control should handle 
the Return key itself. 

Trapping the Return key by the con¬ 
trol is different from trapping other 
keys, because the Dialog Manager han¬ 
dles the Return key in a special way: 
when the user presses the Return key, 
the default pushbutton is activated. 
Though this functionality is nice in 
most situations, it is not useful if you 
would like to process the Return key in 
the control itself. 

This tip explains how you to trap the 
Return key in a control. Some of the 
information presented was not part of 
the Windows SDK, but was explained 
in a Knowledge Base article on the 
MSDN CD-ROM. See the article "INF: 
Using the WM_GETDLGCODE mes¬ 
sage," (PSS ID Number: Q83302) on the 
MSDN CD-ROM for more details, but I 
will present the relevant information 
here. 


WM_GETDLGCODE 

Windows sends the WM_GETDLGCODE 
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message to controls in a dialog box or in a window where the 
IsDi al ogMessage() funnction handles keyboard input. 
Windows sends the WM_GETDLGCODE message to a control to 
determine whether the control will process a particular type of 
input (like arrow keys. Return key. Tab key, etc.). Generally a 
control processes this message to prevent Windows from per¬ 
forming default processing in response to keyboard messages 
like WM_KEYUP, WM_CHAR, WM_SYSCHAR, etc. The return value from 
this message tells Windows if the control requires the particu¬ 
lar keystroke or if Windows should perform default process¬ 
ing. 

Though the Windows 3.1 SDK documentation mentions 
that the WM_GETDLGCODE message does not use wParam and 
1 Param, 1 Param does contain information. 1 Pa ram, if not NULL, is 
a FAR pointer to an MSG structure that contains a message that 
is being sent to the control. Windows versions 3.0 and 3.1 use 
1 Param only to send keyboard input to the control. Keyboard 
messages include WM_KEYDOWN, WM_SYSCHAR, and WM_CHAR. 
Future versions of Windows may use 1 Param to send other 
message types to controls. 

The Solution 

The solution, therefore, is to handle the WM_GETDLGCODE mes- 


Listing 4 

continued 



mov 

ax.OfOOOh 



mov 

sp.ax 



jmp 

high_sta rt 



org 

Of c9h 


next_ 

.block: 




xor 

ax,ax 



xor 

bp,bp 



mov 

bl,5 ; 

5 input chars/4-byte output block! 

next. 

.char: 




inc 

si 



xchg 

ax,bp ; 

Mul old value by 85 


mul 

di 



xchg 

ax,bp 



mul 

di 



mov 

cx,256-21h 



add 

cl,[si] 



add 

ax,cx ; 

and add in the current char (-21h) 


adc 

bp.dx 



dec 

bl 



jnz 

next_char 



push 

bp ; 

Save this block (reverse order!) 


push 

ax 



sub 

bh ,5 ; 

More blocks? 


ja 

next_block 


high 

start: 




mov 

ah,Oah ; Get line 

from stdin! 


mov 

si .offset maxlen 



mov 

dx.si 



mov 

[si],d1 



inc 

si 



Int 

21h 



mov 

bh, [si ] 



mov 

di ,85 ; 85 A 5 > 

A 32 


test 

bh, bh 



jnz 

next_block 



Int 

3 ; 

Breakpoint to stop program! 


end 

start 


: End of File 




Listing 5 dbencode.c 


[[include <$tdio.h> 

^include <stdlib.h> 

#include <string.h> 

typedef unsigned long ulong; 
typedef unsigned int uint; 

^define MAXSIZE 0xfec8 

void prolog(void) 

{ 

printf( 

"eFFC9 33 CO 33 ED B3 5 46 95 F7 E7 95 F7 E7 B9 DF 0 2 C\n"\ 
"eFFDB 3 Cl 13 EA FE CB 75 EC 55 50 80 EF 5 77 DF B4 A BE\n"\ 

"eFFED 5C 0 8B D6 88 14 46 CD 21 8A 3C BF 55 0 84 FF 75 CA CC\n"); 

1 

void encodefiletulong *buf, uint size, char ‘filename) 

{ 

ulong *b, u; 
int p, i; 
char c[6]; 

printf( 

"rsp\n"\ 

"!U\n"\ 

"g-ffea\n",0x100 + ((size + 3) & (~3))); 
c[5] - '\0'; p - 0; 

for (b - (buf + ((size+3)>2));b-- > buf; ) { 

for (u - *b, i - 4; i > 0; 1-- ) { 
c[i] - (u % 85) + 0x21; 



"Visual DLL does the near-impossible, 
turning Visual Basic code into a true 
DLL. creating classes of applications 
previously beyond Visual Basics reach" 

-Windows Sources, 

July 1995 

"Creating a DLL with Visual DLL is a 
surprisingly simple process. You can 
create DLL's callable from any lan¬ 
guage. It's easy, fun and fast!" 

- VB Tech Journal, 

June 1995 



Create Windows DLLs With 
Microsoft ® Visual Basic. 

NO C OR SDK REQUIRED! 

• Create component objects with 
Visual Basic. 

• Creates the true Windows DLL inter 
face. This means applications can 
use the DLL API interface to call 
your Visual Basic functions! 

• Split up large Visual Basic apps into 
smaller more manageable components. 

• Create call-back procedures! Create 
File Manager extensions! Create 
add-on’s and Wizards! Create 

Control Panel “applets”! 

• Automatically generates 
C header files and Basic 
Declare statements. 



Simply Solutions 


TO ORDER OR FOR MORE INFORMATION, CALL: (800) DLL-2405 or (310) 575-5047 
Fax: (702) 831-9711 CompuServe: GO SIMSOL 
email: 74777.3221@compuserve.com 

Simply Solutions, PO Box 930 Tahoe Blvd., Suite 802/374, Incline Village, NV 89451 
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Figure 1 Subclassed window procedure 
handling return keys 


LRESULT FAR PASCAL SubclassedWndProc (HWND hWnd, UINT message, 

WPARAM wParam, LPARAM 
IParam) 

{ 

LPMSG lpMsg; 

UINT nResult; 

switch (message) [ 

case WM_GETDLGCODE: 

// Call the original window procedure to get the return value. 

nResult - Cal 1WindowProc (lpfnOriginalProc, 
hWnd, message, 
wParam, IParam); 

if (IParam) { // IParam could be NULL, so check. 

lpMsg - (LPMSG)1 Pa ram; 

// If pressed key is the return key, 

// do control processing, 
if ((IpMsg-)message — WM_KEYDOWN) && 

(1pMsg-AwParam — VK_RETURN)) { 

// Do your return key 
// processing here. 
nResult |= DLGCJANTMESSAGE; 

// Indicate that control 
// wants the message. 

} 

} 

return nResult; 

i" 

} 

//End of File 


sage and check if the message sent to the control is a WM_KEY - 
DOWN message. If it is, and if the key is VK_RETURN, then the con¬ 
trol should handle it itself and should return a code indicating 
that the control requires the keystroke, thereby bypassing the 
default Windows processing. 

WM_GETDLGCODE return values can be used by user-defined 
controls (custom controls) or in a subclass procedure to mod¬ 
ify the behavior of existing controls. The code fragment in 
Figure 1 is a subclassed procedure to modify the behavior of 
an existing control. In the subclassed procedure, WM_GETDL- 
GCODE is handled as follows. First, the message is passed to the 
original window procedure to get the return value. The code 
then checks to see if IParam contains a valid value. If so, it 
checks if the message is WM_KEYDOWN and if so, if the key is 
VK_RETURN . If it is, then the control handles the Return key on 
its own. To indicate that the control will handle the message 
and that Windows should not perform the default action, the 
procedure ORs the return value from the original window pro¬ 
cedure with DLGC_WANTKEY and returns that value. 

For user-defined controls, the first step — calling the origi¬ 
nal window procedure — is not required. The remaining code 
can be used as is. lpfnOriginalProc points to the control's 
original window procedure. 

Caveat 

Normally when the user hits Return, your control does not 
get keyboard messages (such as WM_KEYUP, WM_KEYDOWN, WM_CHAR, 
etc.). This is because the Dialog Manager processes the Return 
key and activates the default pushbutton. Since your control 
has explicitly asked for the Return key by returning 



hen it comes to text editing have you 
ever hoped for a little divine inter¬ 
vention? Well if it hasn’t arrived yet 
you should be considering PAIGE. 

Whether you’re developing the next “killer” inter¬ 
net application, building a custom publishing tool or 
adding advanced word processing to your CAD pro¬ 
gram, you can’t ignore the quality of your text editor. 

With PAIGE you can create the most sophis¬ 
ticated text features in the business, Including: 

• Stylized Text 

• Text Wrapping 

• Embedded Objects 

• Shapes & Containers 

• Virtual Memory 

• Style Sheet Support 

• Multi-lingual Capable 

• Portable C Code 

• Royalty Free 

PAIGE is written in portable C and uses no global 
variables. Machine specific code is minimized to 


ensure a consistent API 
for all platforms— 
simplifying multi¬ 
platform development. 
This strategy allows 



you to move your 
_ t application to other 

ft* f platforms while r 

taining data and application compatibility. 

To simplify the integration of PAIGE into Windows 
(16-bit, 32-bit, ‘95 or NT) applications, our library 
ships as DLL’s and can be used as a custom control. 
Combined with the message based demo source code 


and simple introduction guide, PAIGE gets programmers 
up and running quickly. 

So why should you buy PAIGE? TIME. Programmers 
can’t afford to reinvent the wheel when implementing 
advanced text features within their applications. 

Join the hundreds of major software publishers 
using PAIGE as their total text solution. For a complete 
technical and pricing summary, or to request our prod¬ 
uct demo, contact the DSI sales department today at 

800-327-6703 or 360-573-9155. 
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DataPak Software Inc. 

9317 NE Hwy 99, #G • Vancouver, WA 98665-8900 
Bus: (360) 573-9155 • Fax: (360) 573-9269 

Internet: 76424.3027@compuserve.com 
www.teleport.coni/~datapak/datapak.html 
AppleLink: D0142 • AOL: DATAPAK1 
• CS: 76424,3027 


“Say, nice job Brother John. Now could you make it a three column 
format with digital memos embedded in the text stream?” 
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DLGC_WANTMESSAGE in the WM_GETDLGCODE processing, you will 
now receive WM_KEYUP, WM_KEYDOWN, and WM_CHAR messages for 
that key. If you are processing the above messages, remember 
that you will get a message for the Return key, since you have 
indicated that you want those messages. If you are subclass¬ 
ing a standard control, you should check for the Return key in 
the above messages and return without calling the original 
procedure, whereas if you have a user-defined control, you 
would ignore the message. 


Listing 5 continued 


u /- 85; 

1 

c[0] = u + 0x21; 

printf("%s",c); 
if ((p +- 5) >- 70) { 
printf(”\n"); 
p - 0; 

) /* endif */ 

} /* endfor */ 

if (p) printf("\n"); /* Flush any partial line! */ 

pr1ntf("\n"); /* End with a blank line! */ 

printf("rcx\n%x\n".size); 
printf("n%s\n".filename); 
printf("w\n"); 


void epilog(void) 

{ 

printf("q\n”); /* Quit from DEBUG! */ 

1 

char *fi1estemichar ‘filename) 

{ 

char ‘stem; 

stem - strrchrtfilename,'\\’); 
if (!stem) 

stem - strrchrtfilename,':'); 
if (stem) 
stem++; 
else 

stem - filename; 
return stem; 

1 

int main(int argc, char *argv[]) 

1 

ulong *buf, filesize; 
uint size; 

FILE *f; 

char filename[80], ‘stem, *ext; 
if (argc < 2) { 

fprintf(stderr,"Usage: dbencode filename > output_fi 1 e\n”); 
return 1; 

1 

buf - (ulong *) mal1oc(MAXSIZE); 
if (!buf) { 

fprintf(stderr,"Could not allocate bytes!\n".MAXSIZE); 
return 1; 

] /* endif *1 

strcpy(filename,argv[l]); 

strlwr(filename); 

stem - fi1estem(fi1ename); 

ext - strrchrtstem,'.'); 

if (!ext) ext = /* dummy name for strlenO call later! */ 


Viewing 


"View" Enable 
Your Application 

Introducing the most extensive viewing libraries- 
Viewing & Conversion Enabling Technology 
(VCET™), an OEM product from C.S.I.. 

Add viewing capabilities for any format within 
your windows application in a matter of hours! 

VCET is the same technology used in AutoVue® 
and other leading viewing and document 
management software. 



VCET "View" 
Window 


"Intergraph uses C.S.I. technology in our DM/View 
and DM/Redline products. The products are well 
received with our customer base." 

Terry Lynch, Executive Director of TIMD, Intergraph Corp. 

"We were easily able to integrate VCET into our 
software application. It was the simplest part of the 
development process." 

Mike Hunting, Project Manager, Kruse Inc. 


Instantly support over 150 file formats! 

Office Documents 

MS-Word, WordPerfect, AMIPRO, MS-Excel, Lotus 123, Quattro Pro, 
dBase, Paradox... 

Engineering Documents 

AutoCAD, MicroStation, CADKEY, HPGL, IGES, CGM, CALS GP4, 
TIFF, Hybrid... 

Desktop Formats 

PS, EPS, JPEG, GIF... 



(800) 361-1904 

C / Tel: (514) 735-3219 

. * V * * * Fax: (514) 735-6440 

Cimmetry Systems Inc. bbs: (5i4) 735-3905 
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Listing 5 continued 


f - fopen ( f 1 1ename,"rb" ); 

if (p < 24) { 

if (If) { 

if (p) strcat(batfi 1 e,"+") ; 

fprlntf ( stderr,"Could not open %s !\n" ,argv [1]) ; 

strcat(batfi 1 e,temp) ; 

return 1; 

) /* endif */ 

) /* endif */ 

p++; 

} 

if (p < 24) { 

fseek(f,01.SEEK END); 

filesize = ftell(f); 

strcat(batf i 1 e, " ”); 

fseek(f,0,SEEK_SET); 

strcat(batfile,filestem(argvtl] )) ; 
strcat(batfi1e,"\r\ndel $.$*\r\n"); 

prologO; 

encodefile((ulong *) 

if ((filesize > MAXSIZE) || 

batfile.strlen(batfi1e),"dbtemp.bat"); 

((strlen(ext) —4) && (strstrC.exe.com.sys.ovl .bin",ext) 

} 1* endif */ 

!- NULL))) { 

} else { 

size = fread(buf,l,MAXSIZE,f); 

/* Do one or more renamed blocks! */ 

encodefiletbuf,size.filestemtargv[l])); 

} /* endif */ 

int p - 0; 

char batfile[256] - "copy lb ", tempt] - 

fclose(f); 

ext = strrchr(temp ,'.'); 

epilogO; 

while ((size = fread(buf,1,MAXSIZE,f)) > 0) { 

return 0; 

ext[2] - (p % 10) + 'O'; 

1 

if (p > 9) ext[l] - (p / 10) + 'O'; 
encodefi 1 e(buf,size,temp); 

/* End of File */ 


Conclusion 

The WM_GETDLGCODE message is a good way to tell the dialog 
manager how to handle keyboard input. It can be used thus to 
circumvent the default Windows behavior for special keys like 


the Return key. Tab keys, arrow keys, etc. For a more detailed 
discussion on the subject refer to the MSDN Knowledge Base 
article mentioned earlier. □ 


EtherViewPro 6.1 for Windows ® 95/DOS 

Special offer: $125 for each version (regularly $245), and get a 
copy of the excellent software, EtherSearchReplace (worth 
$99), absolutely free. This offer is valid through Mar. 31, 1996. 


You have never seen a better user interface in text mode before 
Either ViewPro comes to the market! You can now work in a 
multi-windowing system following CUA plus many advanced 
features such as vertical scroll bars that can be placed on the left- 
hand side. 

In this version, you have a powerful and friendly multi-file 
editor for programmers, EtherEditor . which supports text 
selection and manipulation in different modes, autosave, 
multiple files search and replacement in the memory and/or on 
disks, background printing, each file has its own tab size. A new- 
concept bookmark mechanism lets you easily move between 
dynamic locations when editing, and more! You can also have an 
excellent on-line help browser, Ether Hel p: a help file compiler, 
EtherHC : a screen saver, EtherScreen : Online user’s euide for 
mastering EtherView Pro. 


EtherSearch Replace 2.1 ($99 each copy) 

Lets you find and replace text in multiple files on disks. 
Powerful! Friendly! You will love to use it every day! 


EtherLab Software Technology 
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VERSION CONTROL 


Distributed Revision 
Tracking System 


Parallel Development 

DRTS is based on a powerful software develop¬ 
ment model which allows individuals and teams to 
wofk in parallel. Developers concentrate on developing 
software while DRTS tracks every change. Integrating 
multiple sets of changes is efficient and easy. 


To Order, Call: 1-602-991-8281 

Visa/MC Accepted 

DOS $300 WINDOWS $300 

OS/2 $300 UNIX $500 

Quantity Discounts Available 


ISI 

6325 East Monte Cristo 
Scottsdale, AZ 85254 


Controlled Development 

DRTS is a flexible system which 
adapts to your development 
process. As you develop, 
integrate, test, and 
release, DRTS tracks every 
change at every stage. 
Maintaining multiple 
concurrent releases is 
possible because DRTS 
allows you to easily 
propagate changes 
from one release ti 
the next. 


Distributed Development 

DRTS provides seamless 
integration across 
diverse computing 
environments 
including servers, 
workstations, and 
laptop computers 
running Windows, 
DOS, OS/2 and 
UNIX, Whether your 
development occurs 
on a LAN or between 
multiple sites, DRTS tracks 
changes where they 
are made. 
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Books in Brief 

First Impressions of Recent Titles 


Programming the 'Windows 95 User Interface 
Nancy Winnick Cluts 
Microsoft Press 
376 pages 
$34.95 
1995 

ISBN 1-55615-884-X 

This book is much more focused than the title implies — it 
is really all about the nuts and bolts of using the new 
Windows 95 common controls: status bars, toolbars, trackbars, 
progress bars, up-down controls, animation controls, image 
lists, listview controls, column headers, treeview controls, 
tabs, property sheets, wizards, and rich edit controls. The new 
common dialogs (not much different than the old common 
dialogs, really) are covered, and a smaller portion of the book 
is devoted to writing shell extensions and to manipulating 
shortcuts. Short chapters that have little or nothing to do with 
the main theme of the book, such as covering long filenames 
and the registry, are also included,. The book is less than half 
prose, with the rest being made up of code, screen shots, and 
tables. The code is mostly relevant and I saw no egregious 
padding, but there was clearly no attempt to format the code 
compactly, so most code fragments take up the biggest share 
of a page or more. 

I examined this book while I was making my first attempt 
to use some of these common controls, to see if it would help. 
I was quite disappointed to discover it contained little infor¬ 
mation that was not supplied in the standard Win32 API help 
file. In fact, some of the samples in this book were incorporat¬ 
ed in the Win32 SDK! The online help does not show you how 
to create a listview control or treeview control in a dialog win¬ 
dow — and neither does this book. The online help does not 
point out the many bugs and limitations (how come there's no 


Ron Burk 

"get/set current selection" function for listviews?) in these 
controls — and neither does this book. The online help does 
not show you how to customize a listview control to obtain 
the neat effects seen in Microsoft products like Exchange — 
and neither does this book. The subtitle of this book is "The 
Insider's Guide to Coding the New UI Features", but I didn't 
spot much insider information. I don't see how anyone could 
use the treeview and listview controls in a real-life project and 
have nothing to say about how inconsistent they are with each 
other and with legacy Windows controls. The text is quite 
competently written and understandable and, in all ways 
except the scarcity of useful information not already available, 
I had no complaints. 

The Microsoft Press legal agreement has apparently been 
revised, but it is still written in legalese, still a full page with 
tiny print, and still doesn't give the reader the right to freely 
make use of the code, as far as I can tell. There's a movement 
in the U.S. Congress to have English declared the country's 
official language; I suspect that the lawyers' lobby will already 
have negotiated an exemption that will allow them to contin¬ 
ue speaking in a language explicitly designed to confound 
ordinary citizens. Don't use the code in this book without con¬ 
sulting your attorney. The code has been tested only with a 
Microsoft compiler — like most Microsoft Press books, this 
one ignores the large number of programmers who use 
Borland tools. 

Many people buy books that rehash the online documenta¬ 
tion, simply to have hard copy on hand, or in the hope that a 
different author will present the same information more 
understandably. If you're such a person, this book is certainly 
a competent rehash of the documentation, but a rehash 
nonetheless. My theory is that Microsoft noticed people were 
making good money with superficial reformulations of the 
SDK documentation, and now they've decided to dominate 
that market as well. This book appears on the MSDN CD-ROM, 
so there's no need to buy it if you already have that product. 



Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the books 
that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, expi¬ 
ration date, and phone number. 
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The Microprocessor: A Biography 

Michael S. Malone 

$29.95 

TELOS, The Electronic Library of Science, 
Santa Clara, CA 
Telos (Springer-Verlag), 1995 
ISBN 0-540-94342-0 



[Editor's Note: These comments were provided by Paula 
Tomlinson.] If you're looking for a book to prepare you for 
writing your first device driver, this isn't it. It's exactly what 
the title describes — a story about the development of the 
microprocessor. As with any book about computers that is 
written for a general audience, I cringe a little bit at the sim¬ 
plified descriptions of how computers and electronic devices 
function. That aside, I found the book well written and very 
readable. If you don't have a strong hardware background, 
you might find the high-level description of microprocessor 
fabrication techniques informative. Likewise, "The Future: 
Dreams of Light" presents some intriguing (and some dubi¬ 
ous) possibilities for future substrate materials and fabrication 
processes. 

Just as books about the history of the software industry 
tend to downplay the significance of the hardware, this book 
somewhat downplays the significance of the software indus¬ 
try in the history of the microprocessor. As microprocessors 
incorporate more parallel architectures, performance relies 
even more heavily on very intelligent optimizing compilers 
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and efficient operating systems. All in all, it was an interesting 
light read. 


Migrating to Windows 95 
David Kipping 
Prima Publishing 
856 Pages 

$39.95, includes 3.5" diskette 
1995 

ISBN 1-55958-546-3 

The subtitle of this book is "A Programmer's Guide to 
WIN32 Applications for the New Generation of Windows." 
The main title suggests a great idea for a book: a technical ref¬ 
erence that focuses on the problems of porting 16-bit 
Windows code to Windows 95. The subtitle suggests a really 
bad idea for a book: yet another superficial guide that claims 
to teach "Win32" (how can one book "teach" you about an 
API that has literally thousands of functions at this point?). 
Unfortunately, the subtitle is the more accurate description of 
what the book tries to do. 

After some introductory chapters that provide an overview 
of Windows 95 and the problem it poses for porting 16-bit 
code, Chapter 4 provides a detailed list of portability gotchas 
to watch out for. This is followed by chapters on memory 
management, processes and threads, synchronization, the file 
system, memory-mapped files, DLLs, structured exception 
handling, using DDE for client/server applications, the 
Windows 95 internal architecture, and miscellaneous features. 

Chapter 4 was where the good idea for this book was still¬ 
born. It has concrete, detailed information for people who 
have to port code from Windows 3.x from Windows 95 — all 
in all, quite a worthwhile thing to have. It could have been 
beefed up, not by padding with screen shots and code, but by 
good, old-fashioned research. It could have identified the 
most common porting problems people are hitting and high¬ 
lighted them. It could have been expanded to include a sepa¬ 
rate guide for programmers trying to port from Windows NT 
to Windows 95 (they face a somewhat different set of prob¬ 
lems). All of the above, in the end, that could have resulted in 
a book of perhaps 150 pages that would have been really use¬ 
ful, and easily worth $24.95. It didn't happen, though, and I 
wonder if anyone would publish a useful (or even a useless) 
programming book of less than 200 pages. How would any 
readers find it in a bookstore full of books with two-inch 
spines? 

Outside of Chapter 4, the book tends to be a lot less thor¬ 
ough and useful. The chapter on DLLs claims that . d e f files 
are required (they aren't) and have to have an EXPORTS section 
(they don't). The chapter on DLLs only shows how to export 
via the . def file, and does not discuss how to use 

_decl spec (), a method that a great many programmers will 

prefer or at least need to understand. The 150-page chapter on 
"Using DDE for Client-Server Applications" seemed like an 
odd thing to include. DDE is not really significantly different 
under Windows 95, for one thing, and for another, my impres¬ 
sion is that a lot more programmers are interested in imple- 
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meriting client/server applications with 
mechanisms such as RPC than with 
DDE. 

This book contains close to 900 
pages, even though the really good, fac¬ 
tual content could have fit in 100 pages. 
I probably do not have to tell you what 
a book this size contains — it contains 
code, big wads of code. Not just code, 
but double-spaced code. Double¬ 
spaced code is one of the more cynical 
devices publishers use today; it actually 
makes the code harder to read because 
a single function often won't even fit on 
a page. Compare this to Richter's 
Advanced Windows, which covers much 
of the same ground (and more) better, 
in the same number of pages, using 
only single-spaced code. 

This is not the worst book in the 
world for $39.95, but I can't really rec¬ 
ommend it. Richter's Advanced Windows 
is a much better source of 32-bit 
Windows programming information. 
Or you could just forgo buying a few 
books and spend a couple of hundred 
bucks on the MSDN CD-ROM — that 
has the added benefit of saving a lot of 
trees. 

Let's Talk Books 

Dear Mr. Burk, 

Your Books in Brief column has once 
again saved me serious cash. I was 
almost about to buy Scott Robert Ladd's 
Win32 API Programmer's Reference. But 
your negative review came just in time. 

You see, over here in the Philippines, 
we often have to buy books sight 
unseen from the U.S., since the great 
programming books are not carried by 
most stores here (although most of the 
programming tree-killer books are). It 
takes four months to receive a book if 
sent through the Post Office. If we'd 
like it faster, we ask that it be sent via 
commercial courier, but that costs $20- 
$30. 

The purpose of my letter is to ask 
you if you have had the chance to look 
at Programmer’s Guide to Microsoft 
Windows 95, by Microsoft Corporation, 
ISBN: 1-55165-834-3, Level: Int/Adv, 
Price: $27.95. If so, I was wondering if 
you would recommend it. I was plan¬ 
ning to order this and Richter's book, 
but as usual, I do not have the benefit of 
browsing before I buy. Would buying 
the two books be redundant? 


Though Richter's seems more 
advanced, this Microsoft book may 
cover more of the basics, as the descrip¬ 
tion suggests: 

This book explains how best to use 
the powerful features in Windows 95 
in Win32-based applications, 16-bit 
Windows applications, and MS-DOS- 
based applications. It contains a series 
of articles on Windows 95 written by 
members of the Windows 95 technical 
team, including writers, developers, 
testers, marketers, and application 
localizers. 

Thanks very much. 

Ajig Alcalde 
CompuServe: 76375,1232 

I think it would be very discouraging to 
have to try to pick books without being able 
to leaf through them. And that's on top of 
the markup that most overseas program¬ 
mers pay for books, software tools, etc. We 
tend to think it's difficult to get good 
Windows programming information here in 
the States, but it's certainly doubly hard in 
most other countries. A lot of programmers 
even maintain a U.S. credit card, or a have 
a friend in the U.S. so they can buy stuff 
direct and bypass the often slow and over¬ 
priced local Microsoft representative. What 
a pain! 

At this point, I discourage folks from 
buying the book you mentioned. This is 
basically a hard-copy form of information 
that's in the online SDK helpfile that comes 
with any C++ compiler. Note, however, that 
Microsoft supplied some compiler vendors 
with an out-of-date SDK at around the time 
Win95 shipped, so you need to wait for a 
version newer than Borland C++ v4.52, 
and newer than Watcom C++ vl0.5 to get 
the up-to-date helpfile with those compilers. 
As I mentioned in a book review in this col¬ 
umn, it seems like Microsoft is committed to 
dominating the market for rehashed ver¬ 
sions of their own incorrect and incomplete 
documentation. So, for example, Nancy 
Cluts' little listvieiv example appears in this 
book, in her book, in the SDK helpfile, and 
on the MSDN CD-ROM. How many ways 
can Microsoft get us to pay for the same 
information? I suspect we ain't seen noth¬ 
ing yet... —rib 

Hi Ron, 

I've been reading WDJ for about five 
months now. Personally, I find this jour- 
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nal quite refreshing in that it's got atti¬ 
tude. The first column I turn to is Books 
in Brief, which I find by far the most 
entertaining technical column in any 
mag I've seen so far. 

I heartily agree with your view that 
most books contain a lot of padded 
code and bits of text strewn around as 
"useful" pointers. In most of the cases, 
the text is not even sufficient to cover 
the depth of the material covered in the 
code. A case in point is the book 
Advanced 3D Graphics, by Christoper 
Watkins and Roger Stevens. 

This book purports to teach the read¬ 
er advanced 3D concepts starting with 
transformations and going all the way 
to ray tracing with texture mapping 
and fractals. It also supposedly covers Z 
buffering and hidden surface removal 
and chaos theory. 3D graphics need a 
strong mathematical model and an 
even better conceptual model. The book 
blatantly ignores these important para¬ 
meters. The book is stuffed to the hilt 
with code and more code. Page after 
page is filled with header files and code 
listings. Nowhere is the subject of 
graphics treated properly and exhaus¬ 
tively (at least covering the topics men¬ 
tioned so prominently on the jacket of 
the book). 

I suggest that all book publishers 
and authors actually print the ratio of 
pages devoted to text vs. pages devoted 
to code. Something like this: 

Advanced 3D Graphics - Text:Code 1:20 

This will help readers and buyers make 
a good guess as to the usefulness of the 
book. Because, like me, many people 
I'm sure do not want to directly 
use/read other people's code — we 
want to implement the ideas covered in 
the book and we look at the code only 
for useful pointers illustrating impor¬ 
tant and key concepts, not to directly 
plagiarize it. 

Some real good books that I've read 
in the past are: 

Advanced Windows NT — Jeff Richter 

Inside Windows NT — Helen Custer 

Windows++ — Paul DiLascia 

OLE 2.0 — Kraig Brockschmidt. 
These books are real value for money 
and the authors have taken real pains to 
present useful information, with lots of 
valuable insights that are usually miss- 
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ing in product documentation. I guess 
these guys (and gals) deserve a spot in 
the limelight for their good work. 

Anyways, keep up the great work. 
Here's looking forward to your next 
issue. 

T.V. Haridev 
Persistent Systems Pvt. Ltd. 

Pune, India. 
E-mail: haridev@pspl.ernet.in 

Thanks for the kind words. Books about 
3D graphics have begun to make my eyes 
blur in much the same way that having 
"C++" in the title does. I do own the books 
you did recommend and I happen to agree 
that they are standouts from the pack. 

Various readers have suggested different 
metrics for weeding out the useless books, 
but every time I try one, it actually weeds 
out some good books too. For example, l 
think refusing to buy any book larger than 
500 pages, or with a spine thicker than one 
inch would eliminate a lot of crummy books, 
but then there's the example of Petzold. He 
would not score exceedingly well with the 
metric you suggest, yet his is still one of the 
best general-purpose Windows program¬ 
ming books around. On the other hand, 
there really are books where the ratio is lit¬ 
erally 20 pages of code for each page of text, 
so maybe your metric is useful — when 
there's that little prose, the likelihood I 
would want the book does become vanish¬ 
ingly small. Thanks for the feedback! —rib 

Books Received 

Ken North. Windows Multi-DBMS 
Programming. John Wiley & Sons, 
1995. 784 pages. $59.95, includes CD- 
ROM. ISBN 0-471-01676-4. 

Steve Oualline. Practical C++ 
Programming. O'Reilly & Associates, 
1995. 557 pages. $29.95. ISBN 1- 
56592-139-9. 

Andre LaMothe. Black Art of 3D Game 
Programming. Waite Group Press, 
1995. 1174 pages. $49.95. ISBN 1- 
57169-004-2. 

Nicholas Wilt. Classical Algorithms in 
C++. John Wiley & Sons, 1995. 350 
pages. $39.95. ISBN 0-471-10985-1. 

Ronald C. Turner, Timothy A. Douglass, 
and Audrey J. Turner. README.1ST: 


SGML for Writers and Editors. 
Prentice Hall, 1996. 241 pages. 
$45.00. ISBN 0-13-432717-9. 

Cay S. Horstmann. Mastering C++: An 
Introduction to C++ and Object- 
Oriented Programming for C and Pascal 
Programmers. 2nd Ed. John Wiley & 
Sons, 1996. 292 pages. $40.95. ISBN 
0-471-10427-2. 

Jan L. Harrington. C++ and the Object- 
Oriented Paradigm. John Wiley & 
Sons, 1995. 458 pages. $42.95. ISBN 
0-471-10880-4. 

Herbert Schildt. C++ Nuts & Bolts for 
Experienced Programmers. Osborne 
McGraw-Hill, 1995. 432 pages. 
$24.95. ISBN 0-07-882140-1. 

Ivor Horton. Instant C Programming. 
WROX Press, 1995. 463 pages. 
$24.95. ISBN 1-874416-24-9. 

Noel Jerke. Visual Basic 4.0 Multimedia 
How-To. Waite Group Press, 1995. 
824 pages. $36.95. ISBN 1-57169-013- 
1 . 

Ronald Leach. Object-Oriented Design 
and Programming with C++. AP 
Professional, 1995. 462 pages. $34.95. 
ISBN 0-12-440215-1. 

Prabhat K. Andleigh and Kiran 
Thakrar. Multimedia Systems Design. 
Prentice Hall, 1996. 654 pages. 
$48.00. ISBN 0-13-089095-2. 

Bill Potter, C. Woody Butler, Michael 
Hatmaker, David Jung, Ibrahim 
Malluf, and John Murphy. Visual 
Basic 4 Objects & Classes SuperBible. 
Waite Group Press, 1995. 999 pages. 
$44.95. ISBN 1-57169-006-9. □ 



Let’s face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 
mov dx,offset int_17h_entry 
int 21 h 

mov dx .offset data_4 
mov ah ,9 
int 21 h 


mov dx,19h 
mov ah,31h 
int 


endp 


; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

; DOS Services ah=function 09h 
; display char string at ds:dx 


DOS Services ah=function 31 h 
terminate and stay resident 
al=return code,dx=paragraphs 


int_17h_entry proc 
pushf 


; Push flags 


Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_10_video". And it's fully automatic. 

Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle", undocu¬ 
mented APIs, VxD functions and muchmore. 

Call now! 
1 - 800 - 648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 
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We disagree with 
the person who called 
our conference the 

“COMDEX of software 
development!’ 

It’s a lot cooler 
than COMDEX. 



Register for Software Development 
March 25-29,1996, San Francisco, 

It’s cooler—and a lot more valuable for 
development professionals. So come rub elbows 
with everybody who’s anybody in the field of 
software development. 

Get up to speed on the latest tools for 
object-oriented programming, client/server 
migration and rapid application development. 

And take home skills you can use immediately. 


’96 With 200 classes and 300 tools vendors, SD ’96 is 
p , the largest event of its kind. Covering everything from 
1 component to enterprise application development. 
lifjglggfl To learn more about registering for SD ’96, 
call us at 800.441.8826 or 415.905.2702, or 
send us E-mail at sd96west@mfi.com. For 
N. instant information, visit our Home Page at 

http://www.mfi.com/sdconfs. 

You’ll be all set to attend the conference 
that features far more development tools 
than any other show. Now how cool is that? 


DEVELOPMENT 


More tools. More intelligence. 
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Windows Bug of the Month 

Roger Alley 


=G3= 

Borland C++ V4.52 
Visual C++ vl.5 




Writing code to handle Windows metafiles has never been 
easy. There are a number of things you simply can't do (such 
as using region functions to effect clipping), so when you try 
to use the same code to draw to metafiles as well as to the 
screen or printer, the result is often a lot of ugly code. In addi¬ 
tion, the metafile format has been poorly documented or, in 
the case of the placeable metafile format (developed by Aldus, 
and required by many products), not documented at all. 

While working on a recent project, I learned of another lim¬ 
itation with metafiles. Specifically, using the function 
RestoreOCthdc, nSavedDC) with a positive number for 
nSavedDC resulted in an empty metafile. While this problem 
was fairly easy to fix (we just used -1 for nSavedDC), it took 
quite a while to track down. 

Hang Win95 with UpdateColorsO 

WDJ reader Mike Stratoti has also encountered a problem 
with metafiles. He's found that passing a metafile device con¬ 
text (DC) to UpdateColorsO from a 16-bit app will work in 
Windows 3.1, but in Windows 95 will fault in GDI and then 
hang the system (in fact, the same call in a 32-bit app will also 
hang Windows 95). As Mike points out, passing a metafile DC 


to UpdateColorsO is not a particularly useful thing to do 
(UpdateCol orS () is normally used from a window's WM_PALET- 
TECHANGED message handler, and sent a device context handle 
derived from the window), but hanging the system is still a 
very unfriendly response. 

Unfortunately, there's no real workaround for this bug, 
other than to make sure you're not passing such a DC to 
UpdateColorsO. I did take a look to see why this fails in 
Windows 95 but not Windows 3.1, and found that, in fact, it 
was simply luck that prevented it from failing on Windows 3.1 
(the code in the two systems is actually quite similar). This sit¬ 
uation probably should have been detected in the parameter 
validation code for UpdateColorsO, but neither platform did 
that. The guts of UpdateColorsO, however, is guarded by a 
statement which looks like this: 

if (pDC->pPDeviceBlock->dpRaster & RC_PALETTE) 

It's not really important to understand what all these pointers 
are, but the dpRaster field is what would be passed back from 
GetDeviceCaps (hdc, RASTERCAPS). This statement makes 
sense, in that UpdateCol ors () is only appropriate for a palette 
device. The problem, however, is that metafile DCs have a 
NULL pPDevi ceBl ock, so the code on both platforms just ends up 
looking at what it thinks is a PHYSDEVBLOCK at offset 0 in GDI's 
data segment. On both platforms, the specific byte it ends up 
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Listing 1 testl.c — Hanging Win95 with UpdateColorsQ 

i/include "windows.h" 

// delete the metafile 

UpdateColors (hdc); 

int PASCAL WinMaintHINSTANCE hlnstCurr, 

hmf - CloseMetaFI 1e (hdc); 

HINSTANCE hlnstPrev, LPSTR IpCmdline, int nCmdShow) 

( 

if (hmf) 

DeleteMetaFI 1e (hmf); 

HDC hdc; 

HMETAFILE hmf; 

1 


// That's it 

// Create the MetafileDC 

return 0; 

hdc = CreateMetaFile (NULL); 

) 

If (hdc) 

{ 

// Call UpdateColors, then close and 

/* End of File */ 


looking at is part of an ASCII string, but the strings are differ¬ 
ent, and, as Murphy would dictate, in Windows 95 the bit is 
set, while in Windows 3.1 it is not. The set bit in Win95 causes 
the code to fall into the next section, which is even more ill- 
suited for handling metafile DCs, and quickly crashes, taking 
the system down with it. 

testl.C (Listing 1) shows the source code which demon¬ 
strates this problem. Note that this will hang Windows 95 if 
compiled and run as either a 16-bit or a 32-bit executable. As 
you can see, it doesn't take much in this case to bring down 
the system. Certainly Windows 95 doesn't contain the type of 


safeguards that Windows NT or even OS/2 use to protect 
themselves from faulty applications, but any system is vul¬ 
nerable when its own code turns on itself. 

This is probably a good example of why it sometimes 
seems that it's just as important to be lucky as skillful when 
writing for the Windows API. If you've found your luck fail¬ 
ing on some particular piece of code, or if you've just run into 
a bug in Windows 95, feel free to pass it along to me. If I use 
your bug in this column, you get one of the new Windows 
Developer's Journal t-shirts (much like the old, but with "DOS" 
removed). Send your bug candidate to wdletter@rdpub.com. □ 
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Bug++ of the Month 

Mark Nelson 

The success or failure of big-time software projects often 
depends on the quality of their test programs. For example, 
we tend to assume that vendors like Borland and Microsoft 
have sophisticated test suites, including extensive regression 
tests, for their C++ compilers. Regression tests should ensure 
that all the bug fixes and other improvements from earlier ver¬ 
sions of the product haven't gone bad in the latest revision. 

It's thus not surprising that new releases of C++ compilers 
might have trouble with exceptions or templates. Features 
that haven't yet seen the light of day are bound to have a few 
problems. It's not fun to find this sort of bug, but it isn't a com¬ 
plete surprise, either. 

With the compiler core, though, there's a different expecta¬ 
tion. After years in the field, several major releases, and 
dozens of minor updates, the compiler core ought to be as 
steady as a rock. Updates will no doubt introduce bugs into 
the core compiler, but those bugs should be caught every time 
by that huge body of regression tests — right? 

Last month's bug from Microsoft showed that this isn't 
always the case. Visual C++ v2.2 had trouble with simple inte¬ 
ger multiplication, using language features unchanged from 
Microsoft's introductory effort of years gone by — C++ 7.0. 
The testing required to find that bug would have been rela¬ 
tively simple. 

Borland's Optimization Problem 

Borland has been shipping a C++ compiler considerably 
longer than Microsoft, so their accumulated body of test code 
ought to be even more thorough than that of their Redmond 
brethren. In fact, after taking a few lumps in the quality 
department with the 4.0 release, Borland seemed committed 
to maintaining a top-notch compiler in its 4.5x incarnation. 

WDJ reader Roman Shuf thought so also, until he encoun¬ 


tered a program containing code like that shown in 
bug0296 . cpp (Listing 1). The final value of i after this simple 
stretch of C seems obvious: five. Much to Roman's dismay, 
however, after compiling with default optimization, the pro¬ 
gram shown in bug0296 . cpp prints a value of nine! 

Disassembling the Bug 

This is such a simple stretch of C++ that I thought it might 
be instructive to see just where the code went wrong. By com¬ 
piling with the -S option, you can see the generated code 
mixed in with the C++. The offending stretch of assembly 
looks like this: 

; int i = 1; 

mov si, 1 

; if ( i ) 

or si,si 

je short @1@86 

; i = i + 4; 

lea ax,word ptr [si+4] 

jmp short @1@114 

@ 1 @ 86 : 

; else 

; i = j +4; 

mov ax,word ptr [bp-2] 

@1®114: 

add ax,4 

mov si, ax 


The compiler has decided to keep the variable i in the s i reg¬ 
ister. After testing to see if i is non-zero (which it always is in 
this case), it adds four to it using the lea instruction. It then 
jumps past a short section of code, then mistakenly adds four 
to the result again, before storing it in S i ! This means the addi¬ 
tion operation is performed twice, resulting in an incorrect 
result. 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the author of The C++ Programmer's Guide to the 
Standard Template Library, from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark on 
the Web at http://www.airmail.net/~markn. 
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Listing 1 bug0296.cpp — Showing Borland’s extra addition 

// When using default optimization, this program demonstrates 

1 

// a bug in Borland's 16 bit C++ compiler version 4.5x. It's 

int j - 1; 

// pretty easy to see that when this program executes, i should 

int i - 1; 

// have a value of 5. Instead, a 9 is printed. Examination of 


// the generated assembly code clearly shows that the number 4 

if ( i ) 

// is added to i twice! 

i = i +4; 

II 

else 


i - j + 4; 

//include <iostream.h> 

cout << i; 

void main!) 

//End of File 


A Watcom Object Lifetime Bug 


My monthly column tends to concentrate on the C++ 
compiler offerings from Borland and Microsoft, in part 
because WDJ surveys suggest that these two companies 
represent the lion's share of our readers' purchases. While 
this tight focus may be necessary for the limited space 
available in a magazine, customer demands at my day job 
mean I must take a broader view. Accordingly, I get to 
spend time with some fairly decent products that don't 
get as much attention as they deserve. For example, both 
IBM and Symantec make C++ development systems that 
match up very well with their better known competitors. 

But after sizing up the second tier of vendors, I think 
Watcom really stands out. Long known for the quality of 
their optimization, Watcom has recently added the requi¬ 
site tools for today's compilers: a Windows-based IDE 
and debugger, MFC support, online help, and a certain 
amount of project automation. Add that to their 
unmatched platform support, (including OS/2, NT, 
Winl6, and MS-DOS and DOS Extenders), and you come 
up with a pretty good package. 

Interestingly enough, a couple of readers pointed out 
that the bug that appeared in the November column is 
also broken in Symantec C++ v7.2, not just in the Borland 
and Microsoft compilers. Of the four compilers WDJ cov¬ 
ers, it turns out that Watcom was the only compiler that 
did not have this bug! 

Watcom's C++ compiler has given me very little trou¬ 
ble since their first patch to 10.0, so I was somewhat sur¬ 
prised to run into a language implementation problem. 
After pinning it down, I uploaded the program shown in 
watbug. cpp (Listing 2) to Watcom's CompuServe forum. 

Getting a Vendor Response 

I tend to think of the code in Listing 2 as a "silver plat¬ 
ter" bug report. I've taken the time to pin the bug down 
in a short, simple program that unambiguously demon¬ 
strates the problem. After uploading it to Watcom's 
forum, I expected a quick response. 

After 24 hours with no acknowledgment, I posted a 


follow-up. This missive drew a comment from a "Team 
Powersoft" member indicating that Watcom no longer 
responds to user problems on their forum. 

I couldn't find any announcements on CompuServe 
detailing the best way to get on-line support, but other 
Watcom users kindly directed me to the Watcom Web site. 
Using an HTML form, I submitted my bug to the most 
northern outpost of C++. 

Using the Web to submit the bug did the trick. I got an 
email response fairly quickly, indicating that my report 
had been received. I was also told that if I wished, I could 
receive a tracking number. Given said tracking number, I 
was free to call in from time to time to check on the 
progress of my bug. 

Unfortunately, my schedule doesn't have the slack 
time needed to wait for the sometimes glacial pace of 
compiler bug fixes. Tammie Williams, our benevolent 
overseer ("she who must be obeyed"), has very effective 
ways of making her displeasure known when projects 
start to slip. 

This means bugs like this one have to be worked 
around, for better or worse. In this case, it simply meant 
changing a parameter from a reference argument to a 
value type. 

Summary 

I was a bit disappointed in Watcom's response (or lack 
of it) to this bug, but I can't really fault them for it. 
They've done their best to belly up to the bar with an 
industry-standard compiler, and their support is in line 
with the same set of standards. Borland and Microsoft 
deal with on-line bug reports in nearly identical fashion. 

I can't help but wonder, though, what might happen if 
Watcom combined their award-winning compiler with 
the sort of customer support we used to see from compa¬ 
nies such as WordPerfect. Would that be enough to boost 
them past Borland into the runner-up position for C++ 
vendors? There's no way of knowing, of course, but I 
would surely like to see them give it a shot! □ 
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Borland's Response 

To Borland's credit, Brian Myers quickly acknowledged 
this as a bug, and reported that it has already been fixed in the 
upcoming 5.0 release. Of course, what I would really love to 


know is how a bug this fundamental slipped through the test¬ 
ing process. Was this a one-in-a-million fluke that slipped 
through on a longshot, or does it expose a fundamental weak¬ 
ness in Q/A? 


Listing 2 watbug.cpp — Limited lifetime for a temporary object 


// Watcom tech support, 

II 

II This program is an example of some code that breaks Greenleaf 
// ArchiveLib when used with Watcom C++ 10.0 or 10.5. In this 
// program, function bar() has a reference argument that has a 
// default value. If you call bar() with no args, it gets a 
// reference to a temporary object, as defined in the function 
// signature. 

// 

// The problem with this is that the temporary passed to barf) 

// is destroyed before the function is entered! This means 
// that bar is working with a copy of an object that no longer 
// exists. Running the program with Watcom 10.5 always prints 
// the "Invalid destroyed foo" status. With 10.0, the 16 bit 
// compiler prints garbage instead. Either way, it is symptomatic 
// of the same problem. 

II 

II I don’t have a copy of the draft C++ standard with me at work, 

// so I don’t know if this limited lifetime of a temporary is 
// in fact legitimate. However, I do know that Borland, Microsoft, 
// and Symantec all wait until bar() exits before destroying 
// the temporary. 

II 

II If your compiler is going to work this way, I think that you 
// should issue a warning when you encounter this code. Since my 
// reference argument in var is a const reference to a temporary, 

// you let it through without any warnings. 


II 

// Mark Nelson 
// Greenleaf Software 
// 73650,312 
II 

jfinclude <iostream.h> 

struct foo { 
char *status; 

foo(){ status - "Valid new foo"; } 

foot const fooS ){ status - "Valid copy foo"; } 

void operator-tconst foo& ){ status - "Valid assigned foo"; } 

-foot){ status - "Invalid destroyed foo"; ); 

}; 

void bart const foo & t - foot) ) 

{ 

cout « "Status: " « t.status « end!; 

} 

maint) 

{ 

bar(); 
return 1; 

} 

//End of File 
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ed of the bug trackers." 
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At this time, vendors such as 
Microsoft and Borland tend to keep their 
in-house testing procedures a closely 
held secret. Quality programs such as 
ISO-9000 may open the process up a bit 
in the future, but at this point, that's 
nothing more than speculation. For now, 
vendors seem to feel they have more to 
lose than they have to gain by opening 
the doors on their testing departments. 

Send Us Your Bugs 

Of course, the ultimate Q/A depart¬ 
ment for C++ compiler vendors is the 
programming public. People like Roman 
pay for the privilege of exposing bugs, 
and do so without much in the way of 
thanks. Most users who report bugs 
would be happy with a simple acknowl¬ 
edgment, much less a thank-you. 

On behalf of programmers every¬ 
where, WDJ steps in where vendors fear to 
tread. We not only offer Roman our 
thanks, but we reward him with a striking 
WDJ t-shirt. You can gamer a prize as well 
by submitting a C++ compiler bug that 
proves suitable for publication. Just drop a 
line to us at wdl etter@rdpub . com. We'd love 
to hear from you! O 
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Bypassing Win95 Printer 
Device Drivers 



Ron Burk 


=E3= 

Borland C++ v4.52 
Visual C++ V2.2 




In our August 1995 issue, I wrote an article ("Bypassing Printer Device Drivers") 
about how to bypass printer drivers under Windows 3.1. Since that time, more than 
one reader has asked me how to accomplish the same thing for Windows 95. 1 did¬ 
n't have an answer, since I didn't start exploring Windows 95 in any depth until it 
actually shipped. More recently, this question arose again in the MSWIN32 forum of 
CompuServe, where Paulo Soares asked how to print directly to a port (local or net¬ 
work). I replied that, under Windows 95,1 assumed you could use the new functions 
OpenPrinter(), WritePrinter (), and C1 osePri nter () in an intuitive manner to write 
to a given printer device without the printer device driver interfering. Paulo 
responded that he had tried those functions, and they were difficult to understand 
from the Microsoft documentation. 

I finally took the time to try to use these functions myself, and Paulo was right — 
the Microsoft documentation for these functions is so full of holes that it hinders as 
much as it helps in understanding how to use them. I finally got them to work, and 
the results are in this article. I have used the new functions to make a Windows 95 
version of the "passthru" tool that the August article provided. You can use this tool 
to interactively copy a file directly to a printer, bypassing any printer device driver. 

Why Bypass the Printer Driver? 

There are a number of reasons you might want absolute control over the charac¬ 
ters you send to a printer. For example, I sometimes experiment with little PostScript 
programs that I write myself, so I need a way to send them as-is to the printer. You 
might think that I could just use the Escaped function, with an escape code of 
PASSTHROUGH to accomplish this. However, different printer drivers implement this 
code differently (some not at all), and virtually all printer drivers send an initial 
stream of bytes to the printer to set various parameters, giving you no way to pre¬ 
vent this header data from going to the printer. 


Ron Burk is the editor of Windows Developer's Journal and has been a programmer 
for 12 years. You may contact him at 70302.2566@compuserve.com. 
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You might also think that the best route is to try to write 
directly to the printer port. In practice, that seems to lead to a 
program that will work with local printers, but may not work 
across a network, depending on exactly how the network 
accomplishes redirection for printer ports. The best solution is 
really to use the same functions for printer output that printer 
device drivers use. That allows your printer data to go through 
the spooler, which can be handy sometimes, and guarantees a 
solution that will work correctly with any network printer. 

The Spooler Output Functions 

Under Windows 3.1, the Windows header files included 
pri nt. h, which contained functions that device drivers use for 
printing. With the DDK in hand, you could figure out how to 


use these functions to bypass any printer driver. Under 
Windows 95, the solution seemed much better, since the 
online Windows 95 SDK helpfiles contained documentation 
for OpenPrinter(), Wri tePri nter (), and Cl osePrinter (). In 
practice, though, it turns out that this documentation is so bad 
that you pretty much need the DDK to figure out how to use 
these functions. 

The prototype for OpenPri nter( ) looks like this: 

BOOL OpenPrinter( 

// address of printer or server name 
LPTSTR pPrinterName, 

// address of printer or server handle 
LPHANDLE phPrinter, 

// address of printer defaults structure 
LPPRINTER_DEFAULTS pDefault); 
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♦ No limit to number of simultaneous files 

♦ Fixed & variable length memo records 

♦ Use partial & duplicate keys; automatic 
conversion between C and xBASE types 

♦ Extended field types, auto and manual 
record locks, much much more... 


Library Features 

♦ No royalties 

♦ FREE unshrouded source code 

♦ FREE unlimited phone tech support 

♦ Top-rated documentation AND online 
HELP for Windows, DOS (FREE help 
engine included) 

♦ FREE BBS access, quarterly 
newsletter 

♦ GOLD support available: toll-free 
access to BBS, tech support; FREE 
updates sent to you automatically 

♦ 30-day money-back guarantee 


Call today for complete infor¬ 
mation, demo, or to order. 
MasterCard, VISA, AmEx and 
Novus; approved purchase orders. 


1 - 800 - 523-9830 


(214)248-2561 
FAX: (214)248-7830 
BBS: (214)250-3778 
email: info@gleaf.com 
Web: http://www.gleaf.com/-gleaf 
CompuServe: go greenleaf 

Greenleaf Software, Inc. 
16479 Dallas Parkway, Suite 570 
Dallas, IX 75248 
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The pPrinterName argument looks easy 
until you have to actually supply it. The 
problem is, there is more than one 
"name" for a printer. In fact, the name 
needed here is the so-called "friendly 
name," which is the string the user usu¬ 
ally sees when selecting a printer (e.g., 
"Apple LaserWriter"). The second 
argument really is easy — it's just the 
address of a variable of type HANDLE, 
which is where OpenPri nter () stores the 
printer handle, if it succeeds. The third 
argument is the address of a structure 
but, mercifully, the documentation 
claims you can just pass NULL. 

Once you get OpenPri nter () to suc¬ 
ceed, you quickly discover that 
Wri tePri nterO won't work, and that it 
fails with an error that is not at all help¬ 
ful. From my past experience with the 
Windows 3.1 printer functions, I expect¬ 
ed that I would need to call some kind 
of start/stop functions to indicate to the 
spooler the beginning and end of my 
"print job." The question was, which 
Windows 95 functions should I call, 
since there are a couple of dozen func¬ 
tions for interacting with the print 
spooler, and more than one looked like 
a reasonable candidate. The SDK help- 
files were again useless in helping me 
determine what to do. By scouring the 
DDK documentation, though, I guessed 
(correctly, as it turned out) that after 
calling OpenPri nter (), I needed to call 
the nebulously named 

StartDocPrinterO to tell the spooler 
that I wanted to start writing data, and 
EndDocPrinterO to tell the spooler 
when I was finished writing data. 

StartDocPri nterO has the following 
prototype: 
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DWORD StartDocPrinter( 

// handle of printer object 
HANDLE hPrinter, 

// structure level 
DWORD dwLevel, 

/ / address of structure 
LPBYTE 1pbDocInfo); 

The first argument is simply the handle obtained from 
OpenPri nter(). The second argument specifies the version of 
the structure the third argument points to; no doubt the 
designers of this API anticipated a long series of confusing 
revisions, and they already have one under their belt. If 
dwLevel is 1, then 1 pbDocInfo points to a structure of type 
D0C_INF0_1; if dwLevel is 2, then 1 pbDocInfo points to a struc¬ 
ture of type D0C_INF0_2, which only works with Windows 95, 
not NT. I decided to try the Win95-only version, in part 
because the documentation did not explicitly confirm that the 



Figure 1 Sample app to copy a file directly 
to the printer 


Listing 1 print.c — A function to bypass the printer driver 


/* 

* print.c - code to handle printing a file. 

*/ 

ifinclude <stdio.h> 

#include (string.h> 
i/include (windows.h> 

#define BUFFER_SIZE 4096 

int PrintFi1e(char* PrinterName, char *Port, 

HWND Parent, char *Fi1ename) 

{ 

char MsgBuf[128]; 

char *Buffer - new char[BUFFER_SIZE+1]; 

if(Buffer -- NULL) 

1 

MessageBoxtParent, 

"Insufficient memory for file copy", 
"PassThru", MB_0K|MB_IC0NST0P); 

return FALSE; 

1 

FILE *InputFile = fopen(Fi1ename, "rb"); 
ifdnputFile — NULL) 

1 

sprintf(MsgBuf, 

"Can't open file '%s’ for reading.", Filename); 
MessageBoxtParent, MsgBuf, "PassThru", 

MB_0K|MB_IC0NST0P); 

delete!] Buffer; 
return FALSE; 

1 

HANDLE Printer; 

if(!OpenPrinter(PrinterName, ^Printer, NULL)) 

{ 

wsprintftMsgBuf, "OpenPrinter for '%s’ failed: $ld", 
PrinterName, GetLastError()); 

MessageBoxtNULL, MsgBuf, MB_0K); 

FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM 
|FORMAT_MESSAGE_IGN0RE_INSERTS, NULL, 
GetLastErrorO, MAKELANGID(LANG_NEUTRAL, 
SUBLANGJEUTRAL), MsgBuf, 128, NULL); 
MessageBoxtNULL, MsgBuf, MB_0K); 

delete!] Buffer; 
fclose(InputFile); 
return FALSE; 

] 


// now we have a printer handle 

D0C_INF0_2 Info; 

memset(&Info, 0, sizeof(Info)); 

Info.pDocName - Filename; 

Info.pOutputFile = Port; 

Info.pDatatype - 0; 

Info.dwMode - DI_CHANNEL_WRITE; 

if(IStartDocPrintertPrinter, 2, (LPBYTE)&Info)) 

{ 

wsprintftMsgBuf, "StartDocPrinter on '%s' failed: %1d", 
Port, GetLastErrorO,); 

MessageBoxtNULL, MsgBuf, MB_0K); 

FormatMessaget FORMAT_MESSAGE_FROM_SYSTEM 
|FORMAT_MESSAGE_IGNORE_INSERTS, NULL, 

GetLastErrorO, MAKELANGIDtLANGJEUTRAL, 
SUBLANGJEUTRAL), MsgBuf, 128, NULL); 
MessageBoxtNULL, MsgBuf, MB_0K); 

delete[] Buffer; 
fclose(InputFile); 
return FALSE; 

} 

// now we can start writing data 

HCURSOR OldCursor - SetCursor(LoadCursor(NULL, IDCJAIT)); 

size_t NBytes - 0; 

fort;;) 

{ 

DWORD Written; 

NBytes - fread(Buffer, 1, BUFFERJIZE, InputFile); 
ift NBytes > 0) 

WritePrintertPrinter, Buffer, NBytes, ^Written); 
else 

break; 

1 

SetCursor(OldCursor); 

EndDocPrinter(Printer); 

ClosePrinter(Printer); 
fclose(InputFile); 
delete Buffer; 
return TRUE; 

1 

/* End of File */ 
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old structure would work with Win95, and in part because I 
trust that someday NT and Win95 will be more compatible 
than they are today. D0C_I NF0_2 was the next brick wall, and it 
turned out to require some of the information I thought I was 
escaping by passing a NULL as the third argument to 
OpenPri nter (). 

D0C_INF0_2 has the following definition: 


typedef struct _D0C_INF0_2 { // dci2 
LPTSTR pDocName; 

LPTSTR pOutputFi1e; 

LPTSTR pDatatype; 

DWORD dwMode; 

DWORD Jobld; 

} D0C_INF0_2; 


The Win95 SDK offers no further documentation for that struc¬ 
ture, so you're left to fend for yourself. Again, I had to piece 
together what was needed from DDK documentation and 
samples. pDocName is just a string to attach to this "print job," so 
you can generate whatever mnemonic string makes sense for 
your application. About the only place anyone would see it is 
when viewing spooled print jobs. pOutputFi le was less obvi¬ 
ous; it turned out to be the name of the printer device, such as 
"LPT1:", or a UNC name in the case of a remote printer. 

The pDatatype field was a real enigma. If you read enough 
DDK documentation, you start to figure out that the spooler 
deals with two kinds of spooled data: raw and enhanced 
metafile. Fair enough, clearly I wanted to tell the spooler my data 
was "raw," but what value corresponds to "raw"? In some DDK 
documentation, I found a statement that pDatatype should be set 
to PRINTPROCESS0R_TYPE_RAW or PRINT- 
PROCESSOR_TYPE_EMF, but these constants 
are not defined anywhere in the header 
files. By trial and error, I discovered that 
setting pDatatype to NULL seems to work 
fine. It wasn't clear from the DDK doc¬ 
umentation whether dwMode is even 
implemented under Windows 95, but I 
set it to DI_C H A N N E L_W RITE, which theo¬ 
retically tells the spooler I want to write 
data, rather than control information, to 
the printer port. The documentation 
was unclear on whether Jobld was an 
input or output parameter, so I left it 0 
and everything seemed to work okay. 

After I finally constructed a success¬ 
ful call to StartDocPrinter (), I was able 
to perform a WritePrinter( ) that 
worked (only about six hours after I 
started trying to figure it out). The rest 
was downhill. You can make as many 
calls to Wri tePrinter () as you want to 
write out raw data, then you call 
EndDocPrinter () and ClosePrinter(); 
the only argument they require is the 
printer handle that OpenPrinter() 
returned, print.c (Listing 1) shows a 
basic little function that copies a file to 
the specified printer, bypassing the 
printer device driver. 

Summary 

The code disk (see Table of Contents 
for availability) contains a sample pro¬ 
gram, passthru.exe, which lets you 
select a printer, then copy a file directly 
to that printer. The program displays a 
simple dialog (see Figure 1) and relies 
on common dialogs to let you select a 
file to copy and a printer to copy it to. 
The code disk also contains bldpass.bat, 
a batch file which can build the sample 
program with either Borland C++ v4.52 
or Visual C++ v2.2. □ 





for C/C++ 
-Hut Version 7.0 (New) 

presents Bug # 669 


#include <string.h> 
#include <stdlib.h> 

char *identification() 
{ 

char 


p; 

const char *s 


"CASPAR" 


p = malloc( strlen(s) ); 
if(p) strcpy( p, s ); 
return p; 

} 


The above function is intended to return a freshly allocated data string to serve as 
an identification vehicle but there is a problem with this code. Can you spot it? 
Call if you need a hint. Refer to Bug #669. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Version 7 of PC-lint breaks new ground with 
inter-statement value tracking for both 
automatic variables and class data members. 
Taking clues from assignment statements, 
initializers and conditional expressions it can 
detect out-of-bound subscripts and potential 
null pointer uses. As an enabling technology, 
almost 100 standard functions are rigorously 
checked. Also macros are subject to increased 
scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 
Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches. 


iofaniE 


inadvertent name-hiding, suspicious 
expressions, etc., etc. 

Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lintfor C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2. NT and Windows 95. 
This introductory price is subject to increase. 

FlexeLintfor C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


w 


3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

30 Day Money-back Guarantee. 


PA add 6 % sales tax. 


PC-lint and FlexeLint are trademarks of Gimpel Software 
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Last month (January 1996) I showed how to avoid the pit- 
falls of the SDK documentation and correctly handle the Plug 
and Play WM_DE V ICECHANGE notification. In this column, I will 
wrap up my look at Plug and Play by describing some related 
functions and events. 

BroadcastSystemMessageO 

WM_DEVICECHANGE messages are generated by calls to the 
new Win32 routine BroadcastSystemMessageO. (Like the 
WM_DEVICECHANGE message itself, BroadcastSystemMessageO is 
not supported by the current version of NT, but will appear in 
a future version.) Ordinarily, the operating system controls the 
generation of device change messages, but there may be occa¬ 
sions when an application might want to broadcast a private, 
user-defined device change notification. The prototype for 
this function is: 

long BroadcastSystemMessage( 

DWORD dwFlags, 

LPDWORD 1pdwRecipients, 

UINT uiMessage, 

WPARAM wParam, 

LPARAM 1Param); 


where the first argument contains flags that alter how the 
function goes about its work, the second argument contains 
and receives information about which types of targets to 
broadcast to (applications, network drivers, system VxDs, 
etc.), and the remaining parameters specify the message to be 
sent and its parameters. 

In the example program indevchg.c (Listing 1), I wanted to 
use BroadcastSystemMessageO to broadcast a custom 
WM_DEVICECHANGE message. As I described last month, 
WM_DEVICECHANGE messages arrive with wParam equal to a notifi¬ 
cation code and 1 Param pointing to a structure (the precise 
type of which you have to figure out at runtime). Although it's 
not mentioned in the documentation, one of the event types 
that wParam can be equal to is DBTJJSERDEFINED, which is the 
appropriate code to use if you need to broadcast a custom 
WM_DEVICECHANGE message. That leaves the question of what 
1 Pa ram should be set to. Even if you are going to a send a cus¬ 
tom message of your own invention, you are not necessarily 
free to put any value you want in 1 Param. The reason is that 
this message may get sent to applications other than the one 
calling BroadcastSystemMessage( ). Thus if 1 Param is to contain 
a pointer to additional information, the operating system 
must have a way to figure out the size of the data that 1 Pa ram 
points to, so that it can copy the data into the callee's address 
space and make 1 Param a pointer valid in the callee's address 
space. 


Paula Tomlinson has been developing DOS, Windows and Windows-NT based applications and device drivers for eight years. The opin¬ 
ions expressed here are hers alone. She can be contacted via the internet at paulat@microsoft.com. 
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Once again, the reference information is a little bit skimpy. 
When using the D BT_U SERDEFINED event type to send a 
WM_DEVICECHANGE message, you are essentially required to have 
1 Pa ram point to a data structure of the format I used in my 
MY_USERDEFINED_INFO structure in devchg.c (Listing 1): 


Listing 1 Sample code to handle notifica¬ 
tions 


// devchg.c 

#include <windows.h> 
#include <dbt.h> 

#include <pbt.h> 


/(define DLGJEVCHG 1000 
/(define ID_LB_SYSMSGS 1001 
/(define ID_BT_SUSPEND 1002 
/(define IDJTJROADCAST 1003 


LRESULT CALLBACK DevChgDlgProcCHWND, UINT. WPARAM, LPARAM); 
int ShowDeviceChange(HWND, LPARAM, WPARAM); 
int ShowDisplayChangeCHWND, LPARAM, WPARAM); 
int ShowPowerChange(HWND, LPARAM, WPARAM); 


/(define DBT_DEVTYP_PAULAT 0x80000111 

typedef struct tagMY_USERDEFINED_INF0 { 
struct _DEV_BR0ADCAST_HDR DBHdr; 
char szName[32]; 

//BYTE UserDefined[USER_LENGTH]; 

} MY_USERDEFINED_1NF0; 


Prolndex 



Full-Text Indexing and Retrieval 
Development Toolkit! 


r 




Powerful 

Unlimited document size and quantity 
Full control of document parsing 
Keyword, Boolean, Wildcard 
Phrase, Proximity 
Paraphrase, Delimited Search 
Multi-level nested expressions 

Dynamic 

Full multi-user support 
Work with LAN, WAN, and Internet 
Simultaneous indexing and retrieval 
Efficient index base tuning 


Portable 

DOS, Windows (3.1, NT, 95), 

OS/2, Macintosh, NeXT, Unix 

C/C++, VB, Delphi, and others 

Unicode, Asian, and European 
character support 

Fast 

Unequaled indexing speed 
Fast complex searches 
Find the EXACT location of a search 
Perfect for CD-ROM Applications! 

J 


Or InfoSphere 

Enhancing the accessibility of informationI 

PO Box 225, Pleasant Grove, UT 84062 
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typedef struct tagMY_USERDEFINED_INF0 { 
struct _DEV_BR0ADCAST_HDR DBHdr; 
char szName[32]; 

//BYTE UserDefined[USER_LENGTH]; 

} MYJSERDEFINEDJNFO; 


(text and Listing 1 continued on page 66) 

Listing 1 continued 

MYJSERDEFINEDJNFO Info; 

/** ..... **/ 


int APIENTRY WinMain(HINSTANCE hlnstance, 

HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow) 

1 

return DialogBox(hlnstance, MAKEINTRESOURCE(DLGJEVCHG), 
NULL, DevChgDlgProc); 

} // WinMain 

j-kk ---** j 

LRESULT CALLBACK DevChgDlgProc(HWND hDlg, UINT uMsg, 

WPARAM wParam, LPARAM IParam) 

{ 

switch (uMsg) { 

case WMJISPLAYCHANGE: 

return ShowDisplayChange(hDlg, IParam, wParam); 

case WM_P0WERBR0ADCAST: 

return ShowPowerChangethDlg, IParam, wParam); 

case WMJOMMAND; 

switch!LOWORD(wParam)) { 
case ID_BTJROADCAST; f 

DWORD dwRecipients - BSM_APPLICATI0NS; 
Info.DBHdr.dbch_devicetype - DBT_DEVTYP_PAULAT; 
Info.DBHdr.dbch_size - 
sizeof (MYJSERDEFINEDJNFO); 

lstrcpydnfo.szName, TEXT("PaulaTWSomeData")); 
BroadcastSystemMessage(0, MwRecipients, 
WMJEVICECHANGE, DBTJSERDEFINED, 

(LPARAM)&Info); 

} break; 

case ID_BT_SUSPEND: 

SetSystemPowerStateCTRUE, FALSE); 
break; 

case ID0K: 

EndDia 1og(hDlg, TRUE); 
return TRUE; 

default: 

break; 

1 

} 

return FALSE; 

) // DevChangeDlgProc 


// 

int ShowDisplayChange(HWND hDlg, LPARAM IParam, WPARAM wParam) 

{ 

TCHAR szMsg[MAX_PATH]; 

wsprintf (szMsg, TEXT ("WMJISPLAYCHANGE, Xd x Xd, Xd bits"), 
L0W0RD(1 Pa ram), HIWORDd Param), wParam); 

SendDlgItemMessage(hDlg, ID_LB_SYSMSGS, LB_ADDSTRING, 0, 

(LPARAM HLPTSTR) szMsg); 
return TRUE; 

} // ShowDisplayChange 

// 

int ShowPowerChange(HWND hDlg, LPARAM IParam, WPARAM wParam) 

{ 

TCHAR szMsg[MAX_PATH]; 
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Writing Windows VxDS and Device 
Drivers 

By Karen Hazzah 

Karen Hazzah explains the full range of 
alternatives for interfacing Windows 
applications to hardware, from the 
simplest DLL (Dynamic Link Library) or 
TSR to complex VxDs (Virtual Device 
Drivers). Karen shows how to write a 
VxD without burying the reader in 
Windows trivia and API references. This 
book is not for the beginner. These 
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calls to DOS using interrupt INT21. 
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Windows Custom Controls 

By William Smith & Robert Ward 

This book demonstrates how to make 
powerful and usable custom controls for 
Microsoft Widows. The openness of the 
Windows programming environment 
allows the developer a wide range of 
options. Smith & Ward show how to 
exploit this creative opportunity with a 
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and reusability to Windows application 
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MS-DOS System Programming: 

Third edition 

Edited by David Burki & Robert Ward 

Veterans and beginners will all find 
something in this collection to save time 
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Some or the updated chapters include 
critical error handling, modifying the DOS 
boot, interrupt-driven serial I/O, TSRs, 
accessing the global environment, and 
interfacing to the floppy disk controller. 
New chapters include serial 
communications, the floating point 
coprocessor, CD-ROM drivers, Direct 
Memory Access, and the PC speaker. 
Each chapter gives complete details and 
can be read independently. The 
companion disk includes all the code. 

R&D Publications, 1994, 811 pp. 

ISBN 0-13-207382-X 
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RPC for NT 

By Guy Eddon 

RPC for NT shows how to harness the 
power of distributed computing on a PC 
network with a Windows NT server. Guy 
Eddon provides a step-by-step guide to 
developing Remote Procedure Calls. He 
explains standards and requirements, 
how RPC is related to other parts of 
Windows, and how to use RPC with 
parallel processors, multiprocessors, and 
transputers. Use RPC to solve problems 
in a fraction of the time it would take a 
single machine. 

R&D Publications, 1994, 427 pp. 

ISBN 0-13-100223-6 

T58C with disk.$39.95 


V36 with disk. 
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You may FAX your order to 913-841-2624 or 
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CALL TODAY — 913 - 841 - 1631 . 

Or, use the Reader Service card in this magazine. 



□ Request Reader Service #151 □ 

























































Windows 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


Advertiser Index 


You can now get additional information about 
products and services you see advertised four ways! 



O Contact the vendor directly using the 
information in the advertisement.. 


wdrs@rdpub.com 


© Email your request to 

wdrs@rdpub.com. Make sure you 
include the magazine's issue 
number (7.2) and where you would 
like the information sent. 


© Fill in the Reader Service number 
found under the ad or in this index 
on the bound-in Reader Service 
Response Card. Provide the 
requested contact information 
(subscribers can simply attach their 
mailing label), then mail or 
fax (913-841-2624) the card back to us. 



n ] 


800 - 234-0141 


© Use the Instantlnfo FAX response 
service. For immediate information, 
call 800-234-0114 and request 
the Instantlnfo number listed below 
the ad or in this index. 

The information is sent to the FAX 
machine of your choice. 


Some vendors prefer to be contacted directly and do not participate in the Reader Service or Instantlnfo programs. 

For the fastest service, contact the advertiser directly, and let them know you saw their ad in Windows Developer's Journal! 


Advertiser Reader Service 

AccuSoft Corporation.149 

Alex Informatics. 

American Cybernetics.114 

Azalea Software, Inc.181 

Bateman Incorporated.182 

Berkeley Toolworks...163 

Black Ice Software.103 

Blinkinc......125 

Blue Sky Software.107 

Blue Sky Software.156 

Burton Systems Software.110 

C Associates.180 

Career Marketing Associates.157 

Catenary Systems...123 

Cimmetry Group..133 

Cypress Software.171 


Instantlnfo Page 

.C3 

.76 

.21 

.1110.80 

.80 

.77 

.8 

.31 

.13 

.76 

.16 

.80 

.76 

.1052.30 

.43 

.78 


Advertiser Reader Service 

D&L Online, Inc.173 

DataPak Software Inc. 132 

DC Micro Development.177 

Distinct Corp.101 

DT Software.161 

Dundas Software Ltd.118 

Eschalon Development.109 

EtherLab Software Tech.134 

Faircom.104 

Feistenauer Informationstech.127 

Gimpel Software. 

Great Lakes Business Solutions.106 

Greenleaf Software.145 

HyperAct, Inc.140 

HyperAct, Inc.148 

HyperAct, Inc.153 


Instantlnfo Page 

.79 

.42 

.1099.79 

.5 

.77 

.1101.25 

.15 

.44 

.9 

.34 

.1082.60 

.11 

.58 

.52 

.67 

.75 


Page 64 — Windows Developer’s Journal 


February 1996 


































































































1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2743 USA 
(913)841-1631 FAX: (913)841-2624 


FREE 

PRODUCT 

INFORMATION! 

o receive additional information 
about the products advertised 
in this magazine, circle the 
corresponding Reader Service 
jmbers. Drop this postage-paid 
card in the mail, or FAX it to 
(913) 841-2624. 

For faster service, email your 
election to wdrs@rdpub.com. 
Be sure to include this issue’s 
number (7.2). 

Please circle no more than 
30 numbers. 







Windows 

□ DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 


101 

116 

131 

146 

161 

176 

191 

206 

221 

236 

251 

266 

281 

296 

311 

326 

341 

356 

371 

386 

102 

117 

132 

147 

162 

177 

192 

207 

222 

237 

252 

267 

282 

297 

312 

327 

342 

357 

372 

387 

103 

118 

133 

148 

163 

178 

193 

208 

223 

238 

253 

268 

283 

298 

313 

328 

343 

358 

373 

388 

104 

119 

134 

149 

164 

179 

194 

209 

224 

239 

254 

269 

284 

299 

314 

329 

344 

359 

374 

389 

105 

120 

135 

150 

165 

180 

195 

210 

225 

240 

255 

270 

285 

300 

315 

330 

345 

360 

375 

390 

106 

121 

136 

151 

166 

181 

196 

211 

226 

241 

256 

271 

286 

301 

316 

331 

346 

361 

376 

391 

107 

122 

137 

152 

167 

182 

197 

212 

227 

242 

257 

272 

287 

302 

317 

332 

347 

362 

377 

392 

108 

123 

138 

153 

168 

183 

198 

213 

228 

243 

258 

273 

288 

303 

318 

333 

348 

363 

378 

393 

109 

124 

139 

154 

169 

184 

199 

214 

229 

244 

259 

274 

289 

304 

319 

334 

349 

364 

379 

394 

110 

125 

140 

155 

170 

185 

200 

215 

230 

245 

260 

275 

290 

305 

320 

335 

350 

365 

380 

395 

111 

126 

141 

156 

171 

186 

201 

216 

231 

246 

261 

276 

291 

306 

321 

336 

351 

366 

381 

396 

112 

127 

142 

157 

172 

187 

202 

217 

232 

247 

262 

277 

292 

307 

322 

337 

352 

367 

382 

397 

113 

128 

143 

158 

173 

188 

203 

218 

233 

248 

263 

278 

293 

308 

323 

338 

353 

368 

383 

398 

114 

129 

144 

159 

174 

189 

204 

219 

234 

249 

264 

279 

294 

309 

324 

339 

354 

369 

384 

399 

115 

130 

145 

160 

175 

190 

205 

220 

235 

250 

265 

280 

295 

310 

325 

340 

355 

370 

385 

400 


07.2 


Use with the February 1996 issue 
only. 

□ Please start my subscription to 
Windows Developer's Journal tor 
one year. Bill me 
$34.99 (U.S.); $45 (Canada/Mex¬ 
ico); or $64 (all other countries). 


NAME 


COMPANY/ADDRESS 


ADDRESS 


CITY/STATE/ZIP/MAILCODE/COUNTRY 


PHONE FAX 


Windows’ 

□ DEVELOPER S JOURNAL 

Advanced. Serious. Technical. 

□ YES! Send me 12 issues of Windows Developer’s Journal for only $34.99! 

□ 2 years (24 issues) for $62 □ 3 years (36 issues) for $91 

□ Bill Me □ Visa □ MasterCard 

Number__ Exp._ 

Signature_ 


Name 


Company 


Address 

City 

State 


Zip 


Country/Pro vince/Mailcode 


4PDS 

Please allow up to six weeks for delivery of first issue. Orders outside the US must be prepaid in US funds. CANADA/MEXICO 
subscriptions are: 1 year - $45; 2 years - $75; 3 years - $104. Overseas subscriptions are: 1 year - $64; 2 years - $120; 3 years - $174. 

















NO POSTAGE 
NECESSARY 
IF MAILED 
IN THE 

UNITED STATES 


BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 682 LAWRENCE, KS 
Postage will be paid by addressee 

Windows* 

□ DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 

1601 West 23rd Street, Suite 200 
Lawrence, KS 66046-9950 


lilliiilliilliiiiliililliililnliliiil.lilliii.lilil 


NO POSTAGE 
NECESSARY 
IF MAILED 
IN THE 

UNITED STATES 


BUSINESS REPLY MAIL 

FIRST CLASS PERMIT NO. 1286 Boulder, CO 

Postage will be paid by addressee 

Windows* 

□ DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 

P.O. Box 56565 
Boulder, CO 80323-6565 


11 11 1 1 11 11111 11 111 1 1 1 11 11 111 1 1 1 1 1 1 1 1 1 11 1 111 1 1 11 111 11 


FREE 
PRODUCT 
INFORMATION j 

To receive additional informatic 
about the products advertisec 
in this magazine, circle the 
corresponding Reader Servict 
numbers. Drop this postage-pa 
card in the mail, or FAX it to 
(913) 841-2624. 

For faster service, email your 
selection to wdrs@rdpub.con 
Be sure to include this issue’! 

number (7.2). 

Please circle no more than 
30 numbers. 


C/5 









































Advertiser Reader Service 

Instantlnfo 

Page 

Advertiser Reader Service Instantlnfo 

Page 

IBM Product Compatibility. 

..102. 


.7 


108. 

22 

ILSI. 

..135. 


.44 

Softel vdm. 


...35, 67 


...115. 


.23 


.112. 

18 


...117. 


.24 


170. 

78 

InfoSphere. 

..146. 


.62 

Software Development '96. 

139. 

.50 


..155. 


.76 


166. 

77 

InstallShield. 



.C2 

Software Interphase, Inc. 

129. 

.39 

IRIS SA. 

..154. 


.75 

StratosWare. 

.119. 

.26 


..144. 


.56 


.152. 

75 


..121. 


.28 


.128. 

38 

Lexicus - Motorola. 

..160. 


.77 

Systems Support Group. 

.143. 

.56 

Lifeboat Publishing. 

..100. 


.1 

Syware. 

.172. 

.79 


...116. 


.24 


.184. 

80 


..120. 


.27 


.151. 

75 


..162. 


.77 


.174. 

.79 


...113. 


.20 


.142. 

55 


..136. 


.46 


.150. 

75 


...147. 


.66 



4 


...150. 


.C4 



49 


..105. 


.10 


.122. 

28 


..183. 


.80 


.175. 

.79 

Opt-Tech Data Processing. 

..165. 


.77 

Walnut Creek CDROM. 

.176. 

.79 


..130. 


.40 


.124. 

.30 


..169. 


.78 


Ill. 

17 

RSVP Services. 

..164. 


.77 

Wilson Window Ware. 

.158. 

.76 



.1071... 

.79 


.179. 

79 


...167. 


.77 


.151. 

.. .63 


..168. 


.78 


.178. 

79 


...172. 


.78 


.141. 

52 


...131. 


.41 

7,vT ah Div. of TYCO Tnt'l. 

126 

3? 


Magazine Services 

Instantlnfo Document 

Book Information 

Instantlnfo Document 




.1120 


.1129 




.1122 


1130 

Back Issues. 



.1123 

Illustrated C (Zolman). 


.1131 




.1124 


1132 




.1125 



1133 




.1126 


11.34 



.1127 


1133 




.1128 



1136 





Windows Developer's Bookshelf Catalog. 

.1138 


February 1996 


Windows Developer's Journal — Page 65 











































































































































Listing 1 continued 


1strcpy(szMsg, TEXT("WM_POWERBROADCAST")); 
switch(wParam) { 

case PBT_APMQUERYSUSPEND: // 1Param -- 0; 

1 strcatCszMsg, TEXTC, PBT_APMQUERYSUSPEND")); 
break; 

case PBT_APMQUERYSUSPENDFAILED: 

lstrcat(szMsg, TEXTC, PBT_APMQUERYSUSPENDFAILED")); 
if (1Param & 0x1) 

1strcat(szMsg, TEXTC', OK to prompt user")); 
break; 

case PBT_APMSUSPEND: 

IstrcattszMsg, TEXTC, PBT_APMSUSPEND")); 
break; 

case PBT_APMRESUMESUSPEND: 

IstrcattszMsg, TEXTC, PBT_APMRESUMESUSPEND”)); 
break; 

default: 

IstrcattszMsg, TEXTC, Unknown event")); 
break; 

) 

SendDlgltemMessagethDlg, ID_LB_SYSMSGS, LB_ADDSTRING, 0, 
(LPARAM)tLPTSTR)szMsg); 
return TRUE; 

} // ShowPowerChange 
/* End of File */ 



The user-defined data structure must start with the standard 
DEV_BROADCAST_HDR structure (described in the January 1995 
column) and must be followed by a NULL-terminated string. 
The format suggested for this string is the vendor name fol¬ 
lowed by a backslash character and any remaining textual 
device description. You may also specify additional data fol¬ 
lowing the name string. Anyone processing the 
WM_DEVICECHANGE message must be able to count on a valid 
header and name fields so that they can find out if the mes¬ 
sage is for them or not. 

Note that you can specify what category of recipients you 
wish to receive the message you're broadcasting. Very few 
applications will broadcast their own system messages; this is 
really the role of the operating system and perhaps some dri¬ 
vers. It may be a useful strategy, however, for testing your 
WM_DEVICECHANGE handling code or for communicating with an 
installable driver. Once again. I'll point out that the online ref¬ 
erence mentions a BSF_LPARAMP0 1 NTER flag that I could not find 
defined in any header file. The documentation claims you 
have to set this fictitious flag in the dwFlags argument of 
BroadcastSystemMessaget ) if 1 Param is a pointer to data. In fact, 
the BroadcastSystemMessage( ) routine is apparently able to 
check whether the caller has passed a pointer in 1 Param and 
probably uses the size parameter in the header structure to 
figure out how much data to copy into the address spaces of 
the recipients of the WM_DEVICECHANGE message. For this reason, 
it's critical that any data passed in 1 Param not contain an 
embedded pointer, since such a pointer may not be valid in 
the callee's address space. 

As I mentioned last month, the standard header that 1 Pa ram 
points to for a WM_DEVICECHANGE message looks like this: 

typedef struct _DEV_BROADCAST_HDR { 

ULONG dbch_size; 

ULONG dbch_devicetype; 

ULONG dbch_reserved; 

} DEV_BROADCAST_HDR; 

The online reference incorrectly describes the dbch_size field 
in the header structure as being a 16-bit quantity when, in fact, 
it is a 32-bit ULONG value. The reference information is also pret¬ 
ty vague about what the dbCh_devi cetype parameter should be 
for user-defined events. Although I used a made-up value for 
this field in the sample program, you could also choose to 
ignore this field altogether and key entirely off the dbch_size 
and szName fields. 

Configurations 

Applications should also be aware of the concept of con¬ 
figurations and the new predefined registry key handle, 
HKEY_CURRENT_CONFIG. The current configuration (also referred 
to as the current hardware profile) usually refers to the current 
state your system is docked in. A typical desktop system will 
thus have only one hardware profile, since there is no concept 
of a docked and undocked state. Users can create arbitrary 
hardware profiles if they wish by using the Systems control 
panel applet. You can selectively disable devices in specific 
hardware profiles via the Device Manager in the Systems 
applet. For example, you could create a hardware profile in 
which the network drivers were disabled even though a net- 
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work card is present. Then, for better performance or to con¬ 
serve memory, you could select this hardware profile when 
loading Windows 95 if you knew you would not need to 
access the network at that time. 

Applications can be configuration-aware by storing para¬ 
meters under the HKEY_CURRENT_CONFIG key in the Registry. For 
example, an application that kept track of mouse- or key- 
board-related user preferences might want to store these set¬ 
tings under the H K E Y_C U R R E N T_C 0 N FIG key, since these prefer¬ 
ences are likely to change between a docked and undocked 
portable computer. The operating system actually maintains 
separate registry keys for each hardware profile and aliases 
the HKEY_CURRENT_CONFIG key to the key that corresponds to the 
hardware profile the user booted under. 

There are also three WM_DEVICECHANGE events that applica¬ 
tions can receive regarding configuration changes. The 
DBT_CONFIGCHANGED event is sent when the configuration has 
just changed dynamically (currently the only way the config¬ 
uration can change dynamically is via a dock or undock). The 
DBT_QUERYCHANGECONFIG gives recipients a chance to approve or 
deny a request to change configurations, and DBT_C0N- 
FIGCHANGECANCELED notifies recipients that the configuration 
change was denied. Individual devices that appear or disap¬ 
pear as a result of a dock or undock will cause individual 
WM_DEVICECHANGE events. 


WM_DISPLAYCHANGE 

Another device-related message, WM_D ISP LAYCHANGE, noti¬ 
fies applications of dynamic changes in screen resolution. 
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Though this is not a new message, its definition has changed. 
The wParam parameter originally indicated whether the resolu¬ 
tion had actually changed or not, but it is now used to specify 
the number of bits per pixel for the screen. 1 Pa ram still speci¬ 
fies the new x and y resolution. 

In devchg.c (Listing 1), in response to the WM_D ISPLAYCHANGE 
message, I call ShowDisplayChanged. This routine adds anoth¬ 
er entry to the listbox, describing the new screen resolution 
and bit depth. At this point an application might need to 
resize its window or rescale some of its graphics, etc. 

WM_POWERBROADCAST 

A computer that supports Advanced Power Management 
(APM 1.1) can provide information to both the operating sys¬ 
tem and the application about its current power usage state. 
APM systems can distinguish more states than simply power 
off and power on; there are also standby and suspend states. In 
the suspend state, the system is essentially disabled and most 
devices aren't receiving power. The standby state leaves 
devices running at a lower power state, which conserves 
power while at the same time allowing for quick resumption 
of normal operation. 

Windows 95 broadcasts notifications of power state 
changes. Applications get those notifications, but not after the 
machine enters the standby state. When the machine is in the 
standby state, only the operating system and device drivers 
get notified of state changes. Applications also receive notifi¬ 
cation when the battery power drops below 10 percent. To 
make your application aware of power management, you can 
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call GetSystemPowerState () at startup to determine the initial 
state of the system and the battery. Rather than polling 
GetSystemPowerState! ) periodically after startup, you can 
process the WM_POWERBROADCAST message, which will notify you 
of changes in status. SetSystemPowerState () is a function that 
lets you force the system into the suspend state — few appli¬ 
cations will have a use for this function. Applications can be 
sensitive to power management issues by checking the power 
state before beginning long operations and by saving impor¬ 
tant data when notified that the system is about to be sus¬ 
pended. 

To demonstrate processing the WM_POWERBROADCAST mes¬ 
sage, the ShowPowerChange () routine in devchg.c (Listing 1) 
processes the four suspend notifications and logs the event to 
a listbox. I also demonstrate initiating a suspend operation by 


calling SetSystemPowerState() when the suspend button is 
pressed. I need to point out another error in the online Win32 
references. The references sometimes refer to the power man¬ 
agement events as having a PB_ prefix and other times as hav¬ 
ing a PBT_ prefix. As you'll note in pbt. h, all the power man¬ 
agement events begin with PBT_. 

The current version of Windows NT does not support 
WM_POWERBROADCAST, but does support the less informative 
WM_P0WER, which notifies your application when the machine is 
about to enter the suspended state. 

Conclusion 

The code disk contains a more complete version of the code 
shown in Listing 1 (see the Table of Contents for availability). 
In the sample program there, I demonstrate calling 
BroadcastSystemMessage() when the 
Broadcast button is pressed. As men¬ 
tioned last month, this code will not 
compile with Borland C++ v4.52 or 
Watcom C++ vl0.5 because those com¬ 
piler versions include an out-ofdate 
SDK that is missing dbt. h. 

The role of applications in Plug and 
Play is important but often overlooked. 
Applications must be prepared for a 
device to suddenly become available or 
suddenly go away. Applications should 
try to take advantage of newly arriving 
devices where appropriate and imme¬ 
diately cease accessing devices that 
have been removed. You can start test¬ 
ing and using these new messages on 
Windows 95 now and be ready for a 
future version of Windows NT that has 
full Plug and Play and power manage¬ 
ment support. At the same time, avoid 
relying on any of the obvious 
Windows-95 specific events (anything 
that has to do with a VxD, for 
instance). 

Futher Reading 

Microsoft Corp. "Win32 Application 
Support for Plug and Play." MSDN: 
Backgrounders and White Papers. □ 
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Note that the listview control implements in-place editing • 
by creating an edit control on the fly. Unfortunately, it 
assigns that edit control a child ID of IDOK, which means 
that the parent of the listview control will receive edit 
control notifications that it might not expect. For example, 
if your listview control is in a dialog box, and your dialog 
procedure contains code like this: 

II inside WM_COMMAND handler... 
if(Controlld == IDOK) 

EndDialog(Dialog. TRUE); 

Then it may terminate the dialog when the user starts 
editing a listview item (since the transient edit control will 
send notifications like EN_CHANGE, with a control ID of 
IDOK). The above code should read: 

II inside WM_COMMAND handler... 
if(Controlld == IDOK && NotifyCode == BN_CLICKED) . 
EndDialog(Dialog, TRUE); 

to be safe. _j 
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TowerEiffel Available for NT and Win95 

TowerEiffel is an implementation of the Eiffel 
object-oriented language, now available for Windows 
NT v3.5 and Windows 95. TowerEiffel includes an 
IDE that supports project management. TowerEiffel 
translates Eiffel code into C, which it automatically 
compiles using either Visual C++ or Symantec C++ 
7.0 (not included). The product provides automatic 
system dependency analysis and memory manage¬ 
ment, supports precompiled static and dynamic 
libraries, provides runtime controllable assertion 


checking and exception handling, and can automati¬ 
cally generate documentation in a variety of formats 
(WinHelp, HTML, ASCII text, etc.). TowerEiffel 
comes with over 300 reusable classes, including a sub¬ 
set of the TowerEiffel Booch Components. 

TowerEiffel costs $325 for individual use, or $995 
for commercial use. For more information, contact 
Tower Technology Corporation, 1501 W. Koenig Lane, 
Austin, TX 78756, (512) 452-9455; fax (512) 452-1721; 
tower@twr.com; http://www.cm.cf.ac.uk/Tozverl. 


nu/TPU Multi-Platform Editor Available for Win95 


a/Soft Development has ported its text editor, 
nu/TPU v4.1, to Windows 95. nu/TPU is modeled 
after Digital's Text Processing Utility (TPU), and sup¬ 
ports Digital's EVE, EDT, and WPS interfaces, making 
nu/TPU attractive for Open VMS users who work on 
non-Digital platforms. Features include unlimited 
files and buffers, full programmability, rectangular 
box cut and paste, unlimited undo, Windows and 

Sax Ships Web Browser OCX 

The Sax Webster Control is a new 32-bit OCX that 
allows developers to add World Wide Web connectiv¬ 
ity to Windows applications. The control allows Web 
sessions to be automated, includes table support, and 


Motif support, spawn and shell capabilities, word 
wrap, 80- and 132-column support, wildcard search 
and replace, and support for more than 40 platforms. 

nu/TPU for Windows 95 costs $250 for a single¬ 
session. The cost for networking sessions varies by 
number of sessions. For more information, contact 
a/Soft, 24 Eastman Ave., Bedford, NH 03110, 
(603) 666-6699; fax (603) 666-6460. 


lets developers create menus and forms to present 
users with familiar navigation tools. 

Sax Webster Control costs $149 and is royalty-free. 
For more information, contact Sax Software, 
950 Patterson St., Eugene, OR 97401; (503) 344-2235. 


Windows-on-UNIX Software Adds OLE, Win95 Controls 


Wind/U v3.0 is the latest version of Bristol 
Technology's Windows-on-UNIX development soft¬ 
ware. This release supports OLE 2.0, including OLE 
containers and servers, the component object model, 
and visual editing. Support for Windows 95 common 
controls is also included, covering treeview controls, 
listview controls, property sheets, toolbars, and so on. 


MFC v4.0 is supported, and developers can now use 
their Visual C++ makefiles under UNIX. 

Wind/U v3.0 costs between $5,000 and $9,950. For 
more information, contact Bristol Technology Inc., 
241 Ethati Allen Highway, Ridgefield, CT 06877, 
(203) 438-6969; fax (203) 438-5013; info@bristol.com. 
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RimStar Editor Gains Project Support 

RimStar Technology is shipping RimStar 
Programmer's Editor v4.0, a configurable, multi¬ 
threaded programmer's editor. The editor provides 
language-specific syntax coloring, an ANSI C macro 
language, a C source browser, hex editing, unlimited 
line length, unlimited files and windows, an 
undo/redo capability, keystroke macro recording, 
smart indenting, intelligent paste, bookmarks, and 
configurable keyboard mappings (the product 
includes keyboard mappings for popular editors). 

ProtoView Updates Client/Server Suite 

ProtoGen+ Client/Server Suite v5.0 is the latest 
version of Proto View's RAD software for database 
application development in C/C++. It allows devel¬ 
opers to visually construct 16- or 32-bit desktop and 
client/server database applications. This version fea¬ 
tures support for 16- and 32-bit MFC code generation, 
as well as OWL code generation. The product now 
supports the latest 16- and 32-bit ODBC desktop and 
SQL data drivers for Windows, Windows 95, and 
Windows NT from Intersolv. A visual coder uses 
Pinnacle's Graphic Server to create graphs from 
ODBC data sources. Besides the ProtoGen+ code gen- 


TCP/IP SDK Supports 32-Bit OLE , Win 

Distinct Corporation has released a 32-bit version 
of the Distinct TCP/IP SDK Standard Edition, with 
support for the 32-bit Windows Sockets implementa¬ 
tions of Windows 95 and Windows NT. The SDK con¬ 
tains libraries such as FTP, TNET, ONC RPC/XDR, 
RCP, REXEC, RSH, RLOGIN, SMTP, POP2/POP3, 
and NNTP, as well as applications such as RPCGEN 
and Port Mapper. Each library is designed to work 
over any 32-bit Windows Sockets-compatible TCP/IP 
protocol stack. 

The Distinct TCP/IP 32-bit SDK Visual Edition is a 
32-bit OLE version of the company's SDK. The 

Prolog Tools Available for Win95 

Logic Programming Associates (LPA) has released 
a Windows 95 update for its software development 
tools. The LPA Windows series includes LPA Prolog 
for Windows, a 32-bit development tool for both 
Windows 95 and Windows 3.1; the product features 
an IDE that provides incremental compilation, as well 
as DDE support and a bidirectional interface to DLLs. 
The company's products also includ flex, Prolog++, 
the Database Interface toolkit, the Portable Dialog 
Manager, and the WinProlog Dialog Editor. The new 
Windows 95 release of LPA Prolog features support 


New features in this version include project support, 
file compare, and a file search and replace facility. The 
professional edition of the editor adds C++ class and 
source code browsing capabilities. 

The RimStar Programmer's Editor costs $199 for 
the standard edition (upgrades are $79) or $299 for 
the professional edition (upgrades are $129). For 
more information, contact RimStar Technology Inc., 
91 Halls Mill Road, Newfields, NH 03856, 
(603) 778-2500; fax (603) 778-2408. 


erator, the suite includes DataTable (ProtoView's grid 
component), the WinControl library of data entry 
components, SQLView (a tool for visual database pro¬ 
gramming), the PICS user interface custom control, 
the ProtoView Visual Help Builder, Pinnacle's 
Graphic Server and visual coder, and Crystal Reports 
Pro (a report-writing tool integrated with 
Proto View's visual coder). 

ProtoGen+ Client/Server Suite v5.0 costs $1,999; 
upgrades are $595, or $695 with hardcopy documen¬ 
tation. For more information, contact ProtoView 
Development Corp., 2540 Route 130, Cranbury, NJ 
08512, (609) 655-5000; fax (609) 655-5353. 

j, NT, and VB 

Distinct OLE controls are accessible from Visual Basic 
4.0, or any environment that supports OLE 2.0, such 
as Microsoft Access. 

The Distinct TCP/IP 32-bit SDK costs $495 for the 
standard edition, or $745 with one free year of 
upgrades and technical support. The Distinct TCP/IP 
32-bit SDK Visual Edition costs $295, or $545 with one 
year of free upgrades and technical support. For more 
information, contact Distinct Corporation, 
12901 Saratoga Avenue, Suite 4, Saratoga, CA 95070, 
(408) 366-8933; fax (408) 366-0153; 

http://www.distinct.com. 


for long file names, Windows 95 style dialogs, back¬ 
wards compatibility with Windows 3.1, and a faster 
32-bit inference engine. 

LPA Prolog for Windows costs $745 ($1,495 for the 
developer edition). Prolog++ costs $995 ($1,995 for 
the developer edition), flex costs $1,245 ($2,495 for the 
developer edition). For more information, contact 
Logic Programming Associates Ltd., Studio 4, Royal 
Victoria Patriotic Building, Trinity Road, London 
SW18 3SX, UK, 44 181 871 2016; fax 44 181 874 0449; 
lpa@cix.compulink.co.uk; http://ivwiv.lpa.co.uk. 
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PCLTool SDK Converts PCL5 to Bitmapped/Vector Graphics 


Page Technology Marketing is shipping PCLTool 
Form Conversion SDK v4.0, the latest version of its 
DLL for converting HP PCL5 print files into bitmap 
(.pcx, .tif, etc.) or vector (.wmf) graphic files with 
metrically matching TrueType fonts for those used to 
create the PCL source file. PCLTool uses its own inter¬ 
nal font engine to rasterize fonts at runtime to create 
either bitmap files at various resolutions, or vector 
files with TrueType fonts that match those resident in 
the HP LaserJet Series III. PCLTool includes ptcn- 
vrt.dll, which converts the source PCL file into the 


target file format, creating a placeable and device¬ 
independent file, and ptviewer.dll, which can either 
preview the converted file on the screen or print it to 
the current Windows printer driver. The product 
includes a sample application that uses all the func¬ 
tions of both DLLs. 

The PCLTool SDK prices start at $495. For more 
information, contact PageTech, 10671 Roselle Street, 
Suite 100, San Diego, CA 92121-1525, (800) 748-3668 
or (619) 658-0191; fax (619) 658-0194. 


Async Professional Ships as Delphi VCL Components 


Async Professional for Delphi is a serial communi¬ 
cations library providing ready-to-use terminal win¬ 
dows, and protocol status, modem selection, and 
dialing dialogs as native VCL components for Delphi. 
All the library functions, from serial port access to file 
transfers, are implemented as native VCL compo¬ 
nents. The product offers automatic background 
functions, such as file transfers, dialing, terminal 
updating, and so on. The port component generates 
events under programmer-defined conditions. 
Protocols supported include Z/Y/Zmodem, CIS B+, 
and ASCII. The product includes an event-driven 

VBX Handles Credit Card Verification 

PC-Charge is a new Windows program that can 
process all major credit cards, replacing single-func¬ 
tion, standalone terminals used by many business for 
credit card sales. PC-Charge can process transactions 
one at a time, or in batches. An interface kit for devel¬ 
opers provides a VBX to let you integrate PC-Charge 
into your Window's application; you add the control 
to your form, set various properties, and start run¬ 
ning. An event is triggered when the transaction is 

Mabry Controls Available as OCXs 

Mabry Software has announced that they will ship 
OLE control (OCX) versions of all their VBXs, including 
their Tips VBX and BarCod VBX. Registered owners of 
Mabry's controls can upgrade to the new OLE controls 
for free by calling Mabry's BBS at (206) 634-0783. 


dialing engine, modem database with over 100 pre¬ 
configured modems, and logging and tracing tools 
for debugging. You can use Async Professional for 
Delphi with comm.drv (or compatible drivers) or FOS¬ 
SIL. It includes an ANSI terminal emulator with 
scrollback and capture. 

Async Professional for Delphi costs $179, is royal¬ 
ty-free, and includes source code. For more informa¬ 
tion, contact TurboPower Softivare, P.O. Box 49009, 
Colorado Springs, CO 80949-9009, (800) 333-4160 or 
(719) 260-6641; fax (719) 260-7151. 


complete, and results properties indicate whether the 
transaction was approved or declined. 

PC-Charge for Windows costs $295, the interface 
kit costs another $95, and each additional user costs 
$75 (or $995 for unlimited users). For more informa¬ 
tion, contact Go Softivare, Inc., 31 Sherborne Rd., 
Savannah, GA 31419, (800) 725-9264 (orders) or 
(912) 925-4048; fax (912) 927-0214. 


For more information, contact Mabry Software, 
PO Box 31926, Seattle, WA 98103-1926, 
(206) 634-1443; fax (206) 632-0272; CompuServe 
71231,2066; mabni@halcyon.com. 


Menai File I/O Library Available for Visual Basic 


Menai Corporation's Gamelon file I/O library is 
now available for Visual Basic, packaged as a VBX. 
Gamelon can provide transaction management, 
cross-referencing, and indexing. The files you design 
with Gamelon are portable across the platforms it 
supports, currently including Windows 3.1, Windows 
95, NT, OS/2 (2.x, 3.0, and Warp), and Sun's Solaris. 


Menai also announced that all Gamelon platforms 
now support Unicode. 

The Gamelon VBX costs $195. For more informa¬ 
tion, contact Menai Corporation, 1010 El Camino 
Real, Suite 370, Menlo Park, CA 94025-4335, (415) 
853-6450; fax (415) 853-6453; BBS (415) 617-5726; 
info@menai.com. 
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Fastgraph Available for Windows 

Ted Gruber Software has released Fastgraph for 
Windows, a programming toolkit for developing 
games and graphics applications for Windows 3.1 
and Windows 95. Low-level functionality gives pro¬ 
grammers control over RAM-to-video bitblits, RAM- 
to-RAM pixel manipulations, graphics primitives, 
bitmaps, image files, transparent and non-transparent 
buffer moves, palette management and color reduc¬ 
tion, double and triple buffering, printing, fonts, and 


smooth animation. Both 16- and 32-bit code are sup¬ 
ported under Windows 3.1, as well as native 32-bit 
code under Windows 95. 

Fastgraph for Windows costs $249; current 
Fastgraph 4.0 customers get a $100 discount. For 
more information, contact The Coriolis Group, 
7339 E. Acorna Drive, Suite 7, Scottsdale, AZ 85260, 
(800) 410-0192 or (602) 483-0192; fax (602) 483-0193. 


Crescent Creates Client!Server Tool for VB 


EnQuiry is a new client/server development tool 
that lets Visual Basic v4.0 programmers quickly build 
forms and database queries without coding. Using 
EnQuiry's QueryBuilder, users can graphically man¬ 
age and control the SQL query and control layout 
process. With EnQuiry Form Preview, developers can 
instantly see the results of their queries and how the 


data will be presented to users. 

EnQuiry costs $395. For more information, contact 
Crescent, a division of Progress Software 
Corporation, 14 Oak Park, Bedford, MA 01730, (617) 
280-4000; fax (617) 280-4025; crescent@progress.com; 
http://wwiv.progress.com/crescent. 


CGen Generates C++ Class front Database 


Subtle Software has released the Subtleware Class 
Generator (CGen), an interactive Windows tool that 
creates C++ class definitions from relational database 
schema. CGen lets you connect to a database, select 
tables in the database, and generate class definitions 
that model the selected data. After you generate a 
C++ class with CGen, you can refine the class by 


adding methods, data members, and super-classes. 
The product runs under both Windows 3.x and 
Windows NT and works with databases that use 
ODBC. 

CGen costs $89. For more information, contact 
Subtle Software, Inc., 7 Wells Ave. #27-28, Newton, 
MA 02159, (617) 558-4100; fax (617) 558-4103. 


Windows Editor Features Templates, Outline Editing 


American Cybernetics has updated Multi-Edit for 
Windows, their programmer's text editor. This ver¬ 
sion provides a new edit-on-the-fly template system, 
allowing developers to create and edit templates that 
save retyping frequently used code. This version also 
features outline editing, allowing developers to view 
selected segments of code while collapsing other sec¬ 
tions not currently needed. The product includes hex¬ 
mode editing and a ruler, and supports long file¬ 
names under Windows 95 and Windows NT. Other 


features include background compiling, modeless 
search/replace dialogs, Versions support, improved 
syntax highlighting that allows more key words, and 
revised compiler and color setup. 

Multi-Edit for Windows v7.01 costs $199. For more 
information, contact American Cybernetics, 1830 W. 
University Drive, Suite 112, Tempe, AZ 85281, (602) 
968-1945; fax (602) 966-1654; CompuServe: GO 
CYBERNET; Internet: tech@amcyber.com. 


Clarion for Windows Gets 32-Bit Compiler 


TopSpeed Corporation has announced Clarion 
vl.5 for Windows, a new version of their Rapid 
Application Development environment that features 
a 32-bit compiler and supports Windows 3.x, 
Windows 95, and NT all from the same development 
environment. A new wizard generates multi-thread¬ 
ed applications at the press of a button, based on the 
developer's database dictionary. The data dictionary 
can specify preformatting options, such as defining 
that the window control for a particular field should 
always use a text control with a certain font and font 


style. This feature lets developers set a common look 
for multiple applications that operate on the same 
data. You can nautomatically define the initial data 
dictionary by importing file or table definitions from 
existing databases. 

Clarion vl.5 for Windows has an introductory 
price of $499. For more information, contact TopSpeed 
Corporation, 150 East Sample Road, Pompano 
Beach, FL 33064; (800) 354-5444 or (305) 785-4555; fax 
(305) 946-1650. 
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XVT Nozv Supports Win95 

XVT Software has announced Windows 95 sup¬ 
port with its latest releases of XVT Development 
Solution for C++ (DSC++) and XVT Development 
Solution for C (DSC). Customers on current mainte¬ 
nance with XVT's 32-bit (NT) product will receive 
free upgrades. XVT tools are used to create 
client/server applications that run on multiple plat¬ 
forms. 


C++ Workbench Supports Win95 

Terasoft Technology has released Object 
Engineering Workbench (OEW) for C++ v2.1; this 
version features Windows 95 support. Programmers 
develop applications in C++ using the graphical pro¬ 
gramming tools OEW provides, and OEW generates 
the source code automatically with Microsoft SQL 
Server or Microsoft Access design schema informa¬ 
tion. For object-oriented databases, OEW generates 
design schema for POET and Objectstore OODBMS. 


XVT DSC and XVT DSC++ each cost $2,325 on 
PCsand $7,500 on workstations. For more informa¬ 
tion, contact XVT Software Inc., 4900 Pearl East 
Circle, Boulder, CO 80301, (303) 443-4223; fax (303) 
443-0969; info@xvt.com; http:! Iwww.xvt.comlxvt. 


The product is available for Windows 3.1, Windows 
95, Windows NT, OS/2 Warp, and several UNIX 
workstations. 

OEW for C++ v2.1 costs $795 for a CD-ROM bun¬ 
dle that includes all PC implementations. For more 
information, contact Terasoft Technology 
Corporation, 221 East Main Street, Milford, MA 
01757, (508) 634-8400; fax (508) 634-8236; 
73602.2737@compuserve.com. 


Free Eval Copy of CAD/CAM SDK Available 


Building Block Software is providing free evalua¬ 
tion copies of its CAD/CAM Developer's Kit/2D C 
function library, a library that supports core 
CAD/CAM operations, such as geometry construc¬ 
tion (lines, arcs, circles, ellipses, and NURB splines), 
wireframe display, and 1/O to DXF-format CAD data 
files. The library is written in ANSI C, and comes with 
sample programs for Windows 3.1, Windows NT, 


Windows 95, DOS, and UNIX. 

The retail price of the package with printed docu¬ 
mentation is $999. To obtain a copy of the evaluation 
edition of the CAD/CAM Developer's Kit, contact 
Building Block Software, 77 Pearson Road, 
Somerville, MA 02144, (617) 860-9091; fax (617) 860- 
9066; 70471.734@compuserve.com 


Fax Development Kit Gets Color Support 

Black Ice Software has announced the Complete 
Fax Development Toolkit for Windows NT, consisting 
of Fax C++ (a library that handles sending and receiv¬ 
ing faxes), a Generic Print Capture Driver, and the 
imaging toolkits TIFF SDK and Image SDK Plus. The 
fax send/receive driver supports Class 1, Class 2, and 
Class 2.0 fax modems, and now supports CCITT T.30 
color fax transmission, using CCITT standard JPEG 
data compression. This allows modems to send any 
color image to other BFT-compliant modems. The fax 
C++ class library provides send and receive queue 
management, dynamic fax modem configuration, 


communication port control, and support for over 42 
standard page sizes; it includes both C and C++ inter¬ 
faces. The included print capture drivers can auto¬ 
matically capture monochrome or color print output 
from any Windows application, to generate fax out¬ 
put. 

The components can be purchased separately, or 
together for $2,500 for Windows or $3,500 for NT, roy¬ 
alty free. For more information, contact Black Ice 
Software, Inc., 292 Route 101, Salzburg Square, 
Amherst, NH 03031, (603) 673-1019; fax (603) 672- 
4112. 
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(Piaiv Na: "Context Switch Performance," 
continued from page 28) 

optimization is turned on, the most 
likely result is that the function would 
get inlined (and in fact, probably the 
entire loop would be eliminated), and 
the results would become meaningless. 

For a system call, I picked 
GetTi ckCount( ), which simply reads off 
a timer that changes infrequently. This 
causes no extra work for the operating 
system, but does not allow 
kernel32.dll to cache the result with¬ 
out signalling the OS. 

Results 

I ran my programs on a variety of 
machines and collected the results, 
which are shown in Table 1, with all 
timing numbers in microseconds. The 
P90 is a Dell Dimension XPS Pentium 
90, the 486 is an Intel DX4/100, and the 
DP is a Dell PowerEdge Sp 590-2, a 
dual-processor Pentium. The P66 is a 
Dell Dimension XPS 466V (Pentium 60), 
and the 386/40 is a Domain 386 clone 
with 20Mb of RAM. All machines 
except the Domain have 32Mb of RAM 
and 256K external caches, and both 
external and internal caches were acti¬ 
vated during the test. The Domain 386 
was just an old machine that was lying 
around, so I don't have the specifica¬ 
tions. The 486 was running Windows 
NT Build 944; Build 1057 was the ver¬ 
sion used in all the other runs. Build 944 
was the beta version of Windows NT 
3.51, and I believe there were no sub¬ 
stantial changes between Build 944 and 
Build 1057. 

As expected, the function call tim¬ 
ings remained much the same between 
Windows 95 and Windows NT. The sys¬ 
tem calls exhibit strange results, partic¬ 
ularly where on the P90 running 
Windows 95, GetTi ckCount( ) actually 
seems faster than a standard function 
call. I suspect that this may be because 
GetTickCountO in Windows 95 is in 
kernel 32.dll, which could be in page- 
locked memory across all processes, 
and thus always remain in the cache. Or 
it could be that GetTickCountO uses a 
non-standard calling sequence that is 
smaller and faster than that generated 
for normal C functions. 

Since NT is a multiprocessor operat¬ 


ing system, it naturally tried to sched¬ 
ule both threads to run on different 
processors simultaneously. 

Unfortunately, blocking between 
processors on a shared bus seems to be 
slower than switching contexts within 
the same processor, and the bench¬ 
marks actually run slower on a multi¬ 
processor NT workstation than on a 
uniprocessor workstation running the 
same version of the operating system. 
Further, in the thread-only context 
switch benchmark, where both proces¬ 
sors have to share the same address 
space, the snooping that has to happen 
over the bus (to verify cache coherency) 
apparently causes the benchmark to 
run more slowly than any of the other 
benchmarks running on the same mul¬ 
tiprocessor workstation; the bench¬ 
mark typically runs faster on uniproces¬ 
sor workstations. 

If you run the benchmarks on other 
machines, please send the timing 
results to me via e-mail. 

Conclusions 

For each operating system, there is 
little difference in performance between 
any of the interprocess synchronization 
constructs. However, it takes about two 
and a half times as long on average to 
perform a cross-address-space context 
switch on Windows 95 than on 
Windows NT. I originally bought 
Microsoft's line about Windows 95 
being rewritten from the ground up, 
and this result surprised me. 

Windows 95 did not have to be 
portable, and did not have to worry 
about multiprocessing, hence it should 
perform better on basic operating sys¬ 
tem benchmarks than Windows NT. I 
discussed the result with Andrew 
Schulman on CompuServe, and he sug¬ 
gested that Windows 95 might have to 
dig all the way down to DOS to switch 
PSPs (Program Segment Prefix), even 
when switching contexts between two 
Win32 processes. This would account 
for the large differences, in context- 
switch performance between Windows 
95 and Windows NT. That the ratio dif¬ 
ferences are so consistent across imple¬ 
mentations of the Intel x86 architecture 
is also remarkable. 

Another interesting point is that the 
486DX4/100 seems to be better at con¬ 
text switching than the P90. It is possi¬ 


ble that the simpler pipeline structure of 
the 486 allows context switches to hap¬ 
pen faster than on the Pentium, but at 
this point, any guess is as good as mine. 

What do all these numbers mean for 
the average application? In general, 
Windows 95 multithreads and operat¬ 
ing system context switches are worse 
than Windows NT, so if you're develop¬ 
ing on Windows NT and switching to 
Windows 95 only occasionally, you 
might be in for a big shock if your pro¬ 
gram has many threads that synchro¬ 
nize frequently, or if you have multiple 
processes all talking to each other. Any 
"hot spots" of mutex or semaphore con¬ 
tention will have a larger effect under 
Windows 95 than on Windows NT. 
These benchmarks are small and don't 
swap at all while they are running; if 
the working set sizes of your applica¬ 
tions are larger than available physical 
memory, the machine might start to 
thrash. If you don't need threads, don't 
use them. Also, if you have multiple 
processes synchronizing on some com¬ 
mon synchronization objects, consider 
making the multiple processes different 
threads in one process. Thread context 
switches perform a lot better under 
Windows NT than process context 
switches, and perform no worse under 
Windows 95. 

For multiprocessor NT machines 
and applications running on such 
machines, it might turn out to be faster 
to spawn off multiple processes and 
synchronize between them than to 
spawn off multiple threads within the 
same process. However, given the arti¬ 
ficial nature of these benchmarks it is 
difficult to say if this rule applies to 
real-world applications. 

Finally, I should point out that the 
numbers I'm seeing for context switch¬ 
es are amazingly good. A 133MHz DEC 
Alpha workstation, considered a faster 
machine in all respects, performs 
round-trip context switches in about 
100 microseconds when running Mach, 
a UNIX-like microkernel operating sys¬ 
tem. The efficiency of Windows NT on a 
Pentium more than makes up for the 
slower hardware it has to run on. 
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Readers' Forum 


Send letters to wdletter@rdpub.com. 


To the staff at WDJ: 

On receiving your magazine I was a bit disappointed, as 
it seemed primarily directed at OWL and MFC program¬ 
mers. Self -taught in BASIC, I always considered even PAS¬ 
CAL too cumbersome for simple tasks. Though I have 
learned C++ and Delphi, I still feel more comfortable with 
BASIC and so felt quite astonished at coming across Jim 
Mack's VB pointers article ("Visual Basic's Undocumented 


VarPtr()" — December 1995). Having long programmed for 
DOS with an alchemic mix of QuickBASIC and Assembler, I 
was truly delighted to find a way to access my long lost 
VARPTR function and the power it provides. VB3 is still the 
undisputed winner in Windows product development 
speed, and articles like this help to work around some of its 
freakish limitations. It is a delight to have had my erroneous 
conclusion about your magazine dispelled, and I can only 
commend you for the effort put forth in supporting other 
languages besides today's seemingly omnipotent C. 

Thanks, and keep up the good work! 

Asmfontly yours, 

Roberto E. Olivares 
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$ 39.95 
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SPC Order Number: 
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Using the MFC Windows Controls 

Constructon Kit, you will Quickly master all 
the skills necessary to implement effective 
AND visually appealing dialogs. This quide 
is written by seasoned programmers who 
show you not only how to make the most 
of the existing controls, but also the new 
ones introduced for Windows 95 and 
Windows NT. This book is short on abstrac¬ 
tion and long on practical examples and 
stands as a bridge between the 16 and 32 
bit worlds. This is one book every serious 
MfC developer needs for their library. 
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Jim Mack's article is just the sort of VB piece we've been look¬ 
ing for, and I hope more VB programmers will submit proposals for 
this sort of thing. Most of our readers identify C or C++ as their 
primary programming language, but that does not mean they only 
use that one tool — a great many of them also use VB or Delphi for 
example. While we probably won't ever be the best magazine for 
programmers who only use VB, we do want to help supply the 
information needs of our many readers who keep VB in their arse¬ 
nal of tools. —rib 


From: Thomas Brown 
tomb@west.ivi.com 

I will start by quoting your opening sentence. "We're still 
looking for hands-on Delphi (VB too!) articles that offer use¬ 
ful, reusable code" (From the Editor — Nov. 1995). PLEASE, 
PLEASE do not stray too far down this path. I beg of you. 

I am a C++ developer for Windows. Windows Tech Journal 
used to be a great Windows programming magazine. They 
have since become so wrapped up and mired in the world of 
Visual Basic and Delphi that they have greatly reduced the 


utility of their magazine to developers who use the more 
powerful and lower-level languages. 

As I watched Windows Tech go downhill I was comforted 
by the fact that the world still had WDJ for "real" program¬ 
ming articles. I beseech you that you don't follow that path 
to mediocrity. It may be that the world needs fewer C++ pro¬ 
grammers now that Delphi and VB exist. But those of us who 
are still out here still need advanced, serious and technical 
periodicals to support and educate us. Please don't let us 
down. 

By the way, I love your book reviews. Being as honest and 
blunt as you are is very refreshing in a world were all too 
often people go to the highest bidder. 

One interesting thing about how magazines work is that you 
only get proposals for the sorts of things you already print. For 
example, we've run more VxD articles than any magazine in the 
world, and all I have to do is whisper that our Device Driver theme 
issue is coming up and I'll be deluged with VxD article proposals. 
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Call today, toll free: (800) 962-2949 


Inner Media, Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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j Moving to 
\ WinHelp 95 



Easily 
Move to 
Windows 95 
Help 


The Moving to WinHelp ‘95™ Kit automatically 
converts your existing Windows 3.x Help systems 
to Windows 95 Help systems. 

Automatically adds Windows 95 features to your 
Help systems and updates your source files. 
Works with all Help systems whether they were 
produced manually or with a development tool. 
Includes Mastering Windows 95 Help-the Official 
Book for Help Authoring. 

Call 1-800-718-4406 

now for the fastest and easiest way to 
move existing Help systems to Windows 95. 

BLUE SKY SOFTWARE 

Inti: 1-619459S365 Fax: 1-6194596366 
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WINDOWS DEVELOPERS 

As a headhunter focusing on one area of 
software engineering, I believe I can find you 
the best opportunities. Through constant 
networking I learn of positions all over the 
country. All fees are paid by the client 
company. The market is excellent for talented 
windows developers. Give me a call at 
1-800-638-8903. (CompuServe 73172,663) 
— Gary Patton 


THIS IS YOUR FUTURE 





MlAREER 

MARKETING 

0SSOCIATES 
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•WinEdit 98 • 


$99.95 WinEdit 95 for Windows 95 and 
Windows NT has a 372-function 
Windows macro language, 5 MB file 
handling, compile automation for most 
languages, and automatic text coloring. 

It's for C++ and other languages. Demos 
are free for the download! Or buy under 
our 90 day, money back guarantee. 

• For your free, eval copy: 

BBS: 206-935-5198 
AOL: WindowWare 
CompuServe: WINAPA, Sec. 15 
FTP: www.windowware.com /wwwftp/wilson 
WEB: http://www.windowware.com/wilson/pages/ 
Orders: 1-800-938-4599 
Wilson WindowWare, inc. 
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Lexicus Longhand ™ 

Handwriting Recognition Software 
Windows Developer Version 



• recognizes cursive, print and mixed styles 
• dictionary building tool included 

1-800-LEXICUS or 415-462-6800 
internet: info@lexicus.mot.com 
url: http://www.mot.com/lexicus/ 
Lexicus, A Division of Motorola 

(M) MOTOROLA 
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Instantly Search 
I Megabytes of Text 
or Source Code! 

"Ind ustrial-strengt h... superb.''— PC Magazine 
• Natural language, 
fuzzy, phonic, Boolean, 
proximity, wildcard, 
field & numeric range 
searches. • Searches 

1 with or without index. 

(Indexes up to 10 Mb/min. 
Indexed search time usually under a second.) 

1 Unlimited capacity; works with DBF, OLE 2, 
word processor, ZIP files & more. 

’ Hypertext-linked "hit" displays. • Graphics 
viewer. • Exte nsive batch support. * DDE-API . 

dlSearch®4.0$199, LAN 5 $800. Specify: 

• Win95 /NT(32-bit) • Win3.1 (16-bit). Askabout: 

• 32-bit DLL • Developer’s Joolk'it tor Electronic Publishing 

1-800-IT-FINDS www.dtsearch.com 

DT Software, Inc. (703) 413-3670; lax (703)413-3473 
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The best embeddable 
macro language... 


» is completely compatible with Visual Basic, 

offers such VBA features as keyword 
parameters and With statement. 

• supports full OLE 2.0 automation. 

• provides direct 

access to C++ objects; 
supports polymorphism 
and single inheritance. 

• is application-extensible through functions, 
objects, data types, variables, and constants. 

• includes an Editor/Debugger, an integrated 
Dialog Box Editor, printed and on-line Basic 
documentation -all redistributable to end users. 

• The Editor/Debugger offers breakpoints; step 
into, step out of, step over; watchpoints; 
structures; arrays; expand/contract. 
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Spy on any Windows Program! 


API Vision 


File Edit Tasks API Tfac 

Stopl Window Help 


. § 
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Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more. - 

“Insanely Great” $199+ss ship. 

c r. „ . 4 ... MasterCard, Visa 

Software Development Magazine 30 day money . back gua , antte 


Berkeley Toolworks SKfSr" 

800-593-5103 510-649-9891 apivis@berktool.com 
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1 

I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows 

□ DEVELOPER'S JOURNAL 

- The Magazine for Windows Programmers 


Call 913-841-1631 today for 
information about 
advertising opportunities in 
Windows Developer’s Journal. 


I breakout! marketing - Continental Europe. 

+49 431-801740 

I Ed - East I Christine • Midwest I Julie • West 
913 - 841-1631 1913 - 841-1631 1913 - 841-1631 


f Employment Service 



mail/fax/email resume y 
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Opt-Tech Sort/Merge 


New - Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 * 
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TM 

B SLSOOPE 


SI_SC0PE is a comprehensive serial 
analyzer that enables you to examine, 
and interact with the data on any 
serial line in real time from your PC! 


■ Capture and Analyze at Baud Rates 
up to 115K. 

■ Selectable Formats Including 
ASCII and EBCDIC 

■ Pattern and Signal Searching 

■ Microsecond Timestamp Accuracy 

■ Manual and Cable Included 

■ 3 0 Day Money Back Guarantee 


"Easy lo use and a great tool!" 

- M. Hicks, Clement Industries. 

"Much easier to use than my old Analyzer!" 

- J. Rhoads, Rhoads Systems Inc. 

Software Innovations Inc, 

(914) 567-0805 


A 


63 Rock Cut Rd. Newburgh. NY CompuServe; 75013,3310 
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Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resumd or cmI for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 

CompuServe. 71250,3001 AOL:davesmall 
SP18, Box 19949, Houston. TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8, Box 71, San Ramon. CA 94583 
510-733-6168 Beth@spica.bdt.com 
SPI8. Kenmore Station. Box 15225 
Boston, MA 02215 617-424-8372 jen@spbos.pn.com 
SPI8, P. O. Box 202676. Austin. TX 78720-2676 
V 512-260-0123 lej@dlker.net 
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On the other hand, if we want an article on a topic we don't nor¬ 
mally cover, we pretty much have to shout it from the rooftops, and 
I have to hit the online forums looking for new talent. Thus, when 
you hear me imploring people to send us VB and Delphi articles, 
you should not conclude that we are preparing to make a funda¬ 
mental change in direction. 

Our readers aren't language bigots — they are often using C or 
C++ because it's a good choice for the problem at hand. However, a 
great many of them also use VB — there are a lot of nails for which 
it is the best hammer. So, as more of our readers tell us they're 
using VB and Delphi in addition to C/C++, we’ve been trying for 
quite a while to begin some coverage in those areas. I sometimes 
even hear from programmers who feel we must be actively sur¬ 
passing VB articles, but the fact is I get few or no VB or Delphi 
proposals each month. 

So, you will continue to hear me call for articles on VB, and, 
hopefully, we will eventually be able to devote a regular, small per¬ 
centage of the magazine to that topic, but you will not see VB or 
Delphi taking over the magazine. The challenge is to get the kind of 


VB articles that fit our existing style and audience; I think Jim 
Mack's article was a good example of that. Our readers don't sud¬ 
denly get stupid when they pick up VB — they're still experienced 
programmers, so they don't need tutorials on basic issues. If you 
look on the VB online forums, you find that a significant percent¬ 
age of the traffic is related to understanding the Windows API. No 
matter what higher-level tool you latch on to — VB, Delphi, MFC, 
OWL, or whatever — you eventually hit a limitation and then dis¬ 
cover you still have to understand the Windows API. The 
Windows API is our bread and butter, and will remain the focus of 
Windows Developer's Journal for the foreseeable future. 

Thanks for expressing this concern. It's always good to hear that 
we're doing something basically right and producing something 
valuable enough that readers want to us to be sure and not screw it 
up! —rib 


From: Patrick Tennberg 
To: Paula Tomlinson 

Subject: "Understanding NT" in WDJ November 1995 
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C and C++ DOCUMENTATION 


!! VERSION 6.0!! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index, 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C 1 statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BROWSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
ONT Canada L5N-4M1 http://swbs.idirect.com 


Please see Ad Index for our larger ad. 
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The Fastest xBASE Engine... 

for C, C++, Visual Basic and Delphi 
database application programmers! 

With CodeBase 6.0, you get: 

• Multi-user compatibility with 
FoxPro, Clipper and dBASE files. 

• Portability between Windows, 

Win95, NT, DOS and UNIX. 

• Support for the popular C/C++ 
compilers. Visual Basic and Delphi. 

• Data aware controls for Windows. 

• Powerful visual report writer. 

• Client/Server option. 

• Royalty Free distribution. 

FREE 30 day trial 

Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
Internet: sequiter@supemet.ab.ca 
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Hobart Harney 

World's Fastest Sorting Utilities 
$149 

Postman’s Sort is a linear time general purpose 
file sorting utility for all Intel platforms. 

* Typically 3 times faster than other products. 

* No limit on file size 

* Fixed, Variable, and Data Delimited file types 

* Field types accomodated include alphabetic, 
signed and unsigned binary, packed decimal, 
ascii numeric, ieee floating point among others 

* Flexible and Natural specification of sorting 
fields and collating sequences from command 
line or command file 

* Price includes executables and DLLs for DOS, 
Windows, NT, Win95 and OS/2 and 
distribution license for 50 copies 

3949 1/2 foothill road, santa barbara. California, 93110 
telepho 
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Basic Scripting 


Cypress Enable 2.5 
Basic Scripting for Applications 

A powerful, complete, royalty free, VBA 
compatible, embeddable Basic Scripting 
Language. Cypress Enable Features: Royalty - 
free licensing, 30 day money back guarantee, 
OLE 2.0 Automation, Direct access to C++ 
objects, Dynamic Dialogs, Dialog Editor, 
Debugger (w/source), Recorder, Named 
parameters, Easily extended, Printed and on¬ 
line documentation, Redistributable end-user 
documentation, Small footprint engine < 200K, 
Free technical support. 16 bit $495, 16 & 32 bit 
in one box $995. For a free whitepaper call: 
1-800-790-4050 0 

% 

cc 


email cypress@cypresstnc.com 
Fax:(602) 951-8047.CIS 70444,165 
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C, C++ and Delphi Libraries 
for Windows and NT 


G_FFT Class Library 3.10: Extremely high 
speed Signal Processing routines, Real, 
Complex FFT, Correlation, Convolution, 
Amplitude, Power Spectrum, Filtering, 
Decimation, Data Smoothing, Windowing, 
sorting and more. $149 
G_FFT Professional: Includes G_FFT and 
supports Virtual Memory. Converts over 2 
billion data points. $199 
OOPIot Class Library 3.10: Plotting and 
charting, Linear, Log, Log-Log, Scatter, Bar, 
Pie, Origin setting, Scaling, Real 
Coordinates not integer, MDI support and 
much more. $149 

OOParser Class Library: Expression and 
function evaluator with 1,2, & 3 variables 
and unlimited parameters. $79. 

Sigma Software, Inc. 

15779 Columbia Pike, Suite 360 
Burtonsville, MD 20866 
Call or Fax your order: 301-549-3320 
BBS 301-549-4161 
Download Demo from our BBS. 
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www.dice.com 


Dr. DeeBee 
ODBC Tools 

Tools for ODBC, development 

Ever wonder why 
your ODBC app is not 
working? Why it's just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


Call for a Free ODBC prescription! 



w 

snwfiE— 

RO. Box 91 Kendall 


Connect proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 


Cambridge, MA 02142 

G17- 497-1376 Fax 617-497-8729 
http://www.syware.com/drdeebee/ 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's! 

E XCHANGE . 

A Service of D&L Online, Inc:. (515) 280-1144 



Call TODAY for a FREE special report! 
ULTRA Fax: 214-724-0375 


Financial Systems CompuServe: 71223,634 

1633 Arrowhead Dr, Rower Mound, TX 75028 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



1. Create fantastic prompts 
and save time with VFEdit®'. 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/F DLL™, our Tel 1/F 
Dynamic Link Library. 

3. Scribe plays digital audio 
files without voice hardware! 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


4. Add Text-to-Speech 
capability with Vox Fonts™, 
our text-to-speech library! 

5. Audio ToolBox ™ 
converts between Multimedia 
Wave (16, 8 & MS ADPCM), 
unsigned 8, linear 16, CCITT 
G.711/G.722, Dialogic 4/8 & 
more! Batch convert, crop, 
chop, normalize & filter. Add 
conversion to your apps with 
our ToolBox SDK\ 


VS/ Order Now! 800-234-VISI 


VISI, 2118 Wilshire Btvd, #973, Santa Monica, Ca 90403; 310-392-8780 
Fax: 80 0-234-FXIT / BBS: 310-392-6610 (Download our W orking Demos) 
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X.25, SDLC, HDLC, FRAME RELAY, 
BSC ON THE PC 

Use the Sangoma SDLA card to 

provide synchronous support for your 

product that is cost effective, compliant, 

full featured, rock solid and easy to use. 

• Line speed to 180kbps 

• Compatible with all operating 
systems and environments 

• Operating statistics and built in 
datascope make your product easy 
to configure and debug 

• Primary and secondary SDLC with 
multiple addresses 

• HDLC LAPB, LAPD, NRM mode 

• CCITT 1988 X.25 implementation to 
ISO 8208 


ies Inc. 


SANGOMA Technolog 

Your communications Link 

Tel: (905) 474-1990; (800) 388-2475; FAX: (905) 474-9223 

e-mail: dm@sangoma.com; website: www:sangoma.com 



Free CDROM! 


Sampler CDROM: You get useful samDlesfmm 
44 CDROMs + $5.00 check inside- 


*Free with regular S5.00 shipping charge 


$29.95* * 

$34.95* 


Cica MS Windows: 2-disc set! 4000 new 
prgrms, games, utilities, drivers, code, fonts. 

Simtel MSD0S: Now 2-disc set! 1000 MB 
MSD0S shareware (utils, games, code, etc.) 

Hobbes OS/2: OS/2 Mag's Product of the Year! $29.95' 
600 MB of OS/2 Share/Freeware (2-disc set). 

C Users’ Group Library: C Users'Journal $49.95' 
Archive: 10 yrs of C code & articles 
Source Code : 650 MB C, Usenet Unix, DOS $39.95 
Toolkit for Linux: Slackware 2.0 32-bit 0/S $39.95 
for PC with GNU & XI1. Src. (2-disc set!) 

FreeBSD 2.0: Berkeley BSD, 32-bit 0/S for $39.95 
PC, with GNU &XII. Full source. 

Internet Info: 12,000 computer, network 
Internet documents. FAQ's, RFC's & lEN's 
Space & Astronomy: Thousands of NASA 
images + viewer, 5000 data files, prgrms. 

*shareware reauires separate payment to authors if found useful 

Call Now for our Free Catalog! 1 -800-7 86-9907 

Walnut Creek CDROMIB1HI 
1-510-674-0783 • FAX 1-510-674-0821] 
email: orders@cdrom.com 
4041 Pike Lane, Suite D-692 Concord, CA 94520 | 692 


$39.95 

$39.95 
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1 - 800 - 775-1073 



New Version 3.12 


Never shell out to 
the O/S again! 
Crusher is a robust 
set of functions 
that provide your 
DOS, Windows, 
OS/2 and Unix 
applications high 
performance, portable 
data compression. 


DOS $249 
Windows $299 
OS/2 $349 
Unix $349 
Visa, MasterCard, American 
Express and Discover Cords welcome. 


Features buffer & file 
compression, disk 
spanning, full source 
code and more. 
Windows version 
includes VBX and 
on-line help. 


Free demo on BBS (606) 268-1 251 
Tel (606) 268-1559 Fax (606) 266-0726 


24-hour information by fax 
1-800-234-0141, doc #1151 
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Port I/O on NT/95 


?S<*XvX"XvXvXvXvXvXv’X - IvfrfrXvX - XwXv>X’>X’X , XvXvX , S"X-X’&X-X"£*! 

WinStar Hardware Classes 2,„ 

C++ classes and C API for hardware 
access from Win32 & VB4 applications. 
o Port and physical memory access 
o Interrupt service routines 
o Supports Pofh Windows 95 and NT 
o No DDK development required 

WHC Customization 

We can customize the WHC library with 
your interface routines hardcoded into 
our WHC drivers. True kernel mode 
performance on both NT and 95 for a 
fraction of the cost of ground-up driver 
and VxD development. 

WinStar Technologies^ 

(415) 647-2815 
CompuServe: 74367,1773 
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Data Structures 


The MemSL"* is the most complete 
Data Structures Library for C & C++. 
Includes: 

Single and Double Linked lists, 
Multi-Dimensional Arrays, Hashing Tables, 
Binary Trees, Balanced Trees, Queues, 
Dequeues, Priority Queues, 

AVL and Threaded AVL Trees, 
Memory Tracing and Debugging, 

And More for only $79.99! 

Source Code Included. Royalty Free. 


Windbase® Software Inc. 

P.O. Box 10115* Glendale. AZ 85318-0115 

602-561-8788 

Fax: 602-561-6490 BBS 602-780-9692. N81 
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Hi Paula, 

I read your article with great interest but I have a question 
for you: What is the point of calling Local ReAl 1 oc () in the 
end of your routines Uni codeToMB () and MBToUni code ()? After 
the call to WideCharToMuitibyte () then the size of the string 
should be the correct size, if it isn't, then the contents should 
be wrong. Please enlighten me. 

That's a good question — I wish I'd explained that step in the 
column. Since the Uni codeToMBf) and MBToUni coded routines are 
designed to handle conversions with both single-byte and double¬ 
byte ANSI strings, the memory allocation I do at the beginning of 
each routine is really a worst-case estimate. In other words, when 
converting to Unicode, the biggest the Unicode string could be is 
twice as large as the input string. Likewise, when converting from 
Unicode, the biggest the output string could be is the same size as 
the input string. Remember that multibyte characters can take 
either one or two bytes to store. In my case, I sometimes handle very 


large strings and it's up to the caller to free the string, so it was 
worth the overhead of an extra call to reallocate the string to be the 
exact size required. If your application always deals only with con¬ 
versions to or from ANSI strings then you can exactly predict how 
big the required string will be and avoid the reallocation. Even if 
your application handles multibyte strings, if they tend to be small, 
it might not be worth it to make the extra call to reallocate the mem¬ 
ory. —pit 


Ron, 

One proposal regarding your online files: please remove 
wddjhelp.zip from your archives. Downloading this 180k, 
out-of-date beast for the sixth or seventh time is a bit crazy. 

Manfred Keul 

Good idea, we'll take that out. We may be able to include some 
form of magazine index in our upcoming Web page. —rib O 
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S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer's 
Mind.* 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows. NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


B Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 
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Career advancement 


Let | Associates Expand 
Your Technical Career 




Placement 
Specialists In: 

C & C++ Programming, UNIX 
System Administration, ORACLE, 
ill Sybase, Informix, Progress, FoxPro, 
other relational databases. 


Network Design & Management, 
Sun Workstations, Graphics 
Development,MS & X Windows 
::i:!s Applications 


Please mail or fax your resume to: 


B C Associates 

ATTN: John Capozzi 
P.O. Box 15420, 

Washington, DC 20003-0420 

Phone: 202-544-0821 Fax: 202-547-8357 


Do it today 
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Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 

• File Systems • Kernel Mode Drivers 

• NDIS Drivers • Systems Internals 



105 Route 101 A, Suite 19 

Amherst, NH 03031 

(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 
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Bar Codes Can Be Fun. 
Honest! 

If you can change fonts, you can 
create bar codes. Code 128, Code 
39, UPC, and other symbologies. 


.TM 



azalea 

software^ inc. 


800 48-ASOFT 
20 6 932.6028 
info@azalea.com 
www.azalea.com 
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* Dazzle/VB image manipulation .. $199 

* VBIite - print/comm/array/B-Tree index.. $149 

* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* QuickLine/VB - telephony (multi-line) ...$495 

* SpellCheck/VB - spelling & lookup. $49 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming .. .$80/h 


Develop your VB app faster: Get TeraTech 
tools! Call, E-mail or fax us and we’ll mail you a 
free demo disk ASAP. Or for faster service 
download by FTP or from our BBS. Call now! 

800-447-9120 ext. 1198 

Dept. 1198,100 Park Avenue, Suite 360, Rockville, MD 20850 USA 
Inf1:4-1-301 -424-3903 Fax:(301)762-8185 BBS: (301) 762-8184 
Copyright TeraTech 1995. Al rights reserved. Trademarks are the property of their holders. 


a Request Reader Service #184 n 


Page 80 — Windows Developer’s Journal 


February 1996 




















































Visit our Internet site at http://www.accusoft.com 


Platforms 

Supported 


The Ultimate High Performance Imaging Toolkit! 

Add Support for Over 36 File Formats Instantly ! 


Now with PNG!* 


PERFORMANCE 




SCANNING jGU ARANTEE 
THUMBNAILS PRINTING 


IMAGE 


36 FILE 
FORMATS 


Gray 


COMPRESSION IMPORT 


COLOR 


REDUCTION 


CONVERSION 


to 

m 

a 

n 

in 


AccuSoft Image Format Library 5.0 


Ultimate Imaging Toolkit 

AccuSoft provides the ultimate imaging 
toolkit solution with the highest 
performance, most formats & platforms, 
most complete API and the best pricing. 
That is why we are the industry leader 
and why over 5000 companies have 
chosen AccuSoft for their imaging 
needs! 

Performance 

AccuSoft has always been known as the 
performance leader. We know that you 
want the fastest imaging possible and 
that fast is never fast enough. 

Therefore, we constantly work on 
improving performance to keep us 
(and you) ahead of the competition. 

Quality 

AccuSoft has become the leader in 
imaging toolkits due to our untiring 
commitment to quality. Not just 


Toll Free: (800) 525-3577 

Internet: http://www.accusoft.com 
CompuServe: Go AccuSoft 


product quality, which can be seen in 
our unique guarantees, but also service 
quality from our special fast delivery 
program, top rated technical support and 
rock-solid technology. 

Pro Gold 

The Pro Gold versions of our imaging 
toolkits are unbeatable for performance 
and special features like scale to gray, 
sub-degree rotation, sub-second 
decompress & display, sub-second 
screen rotation, huge image handling 
and more. 

If you want the best performance 
available anywhere at any price, this is 
it. 

Cross Platform 

With this toolkit, you can sell your 
applications on many different platforms 
without having to recode the imaging 
portion. AccuSoft's cross platform 


design is tailored for easy 
porting, and since we 
support ALL platforms, 
your products can be sold to 
every market. 

Order Today 

Call now and you can start 
writing high performance 
imaging applications in less 
than an hour. Our unique 30 
minute delivery program is 
also the fastest in the 
business! 



AccuSoft 

High Performance Imaging' 


Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

All company and brand names are trademarks or registered trademarks of their respective owners. 

*Free Upgrade for 5.0 users. PNG is the replacement format for GIF. 1. Raster only 2. Read only (Does NOT require separate DLL from Kodak.) 

©1995 AccuSoft Corporation. All Rights Reserved. 


Windows 
Win 95\NT 
DOS 
DOS32 
VBX 
OCX 
OS/2 
FoxPro 
SUN OS 
Solaris 
HP-UX 
AIX 
SGI 
SCO 
MAC 

PowerMac 

Over 36 
File Formats 
Supported 

TIFF 
JPEG 
Group III 
Group IV 
PCX 
TGA 
DIB 
DCX 
GIF 
BMP 
WMF' 
PICT' 
WPG’ 
EPS’ 

KFX 

RLE 

LV 

CALS 

ATT 

CLP 

XWD 

IMG 

IFF 

SUN 

XBM 

ICO 

IOCA 

GX2 

XPM 

ASCII 

CUT 

BRK 

MAC 

PSD 

MSP 

PNG 

Photo CD 2 



ACCUSOFT 

IMAGE 

GUARANTEE 


Look for the 
AccuSoft Image 
Guarantee™ 
or the AccuSoft 
trademark on 
your favorite 
software products 
as a statement of 
superior quality. 
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Soft-ICE" For Windows’ 95 

Raw Power To Break Through The System-level Barrier! 


Your 32-bit Application Debugger 
Is Stuck In The Win32 Subsystem, 
But The Bugs Aren't! 

When chasing a tough bug through the 
multiple layers of Windows 95, you need a 
debugger that can easily follow it. You need 
visibility and debugging power to chase 
bugs anywhere they go. When your conven¬ 
tional application debugger falls short, rely 
on Soft-ICE 2.0 for Windows 95 to pull you 
through the toughest debug sessions. 

System crash bugs are particularly frustrating 
without the right tool. Without visibility and 
control, these can take days, or even weeks 
to solve. Soft-ICE gives you visibility with it's 
internal system commands. It can show you 
what led up to the crash with its back trace 
history capability. Soft-ICE also gives you 
real control because it can debug through 
any code in any part of Windows 95. 

Soft-ICE sits right on the metal. It is not 
dependent on any system code. Its In-Circuit 
Emulator (ICE)-like features let you debug any 
Windows 95 code without side effects, and 
without expensive hardware. 

Windows 95 Is Here And 
It Means Change. 

Soft-ICE understands all of the subsystems 
that make up Windows 95. It displays rele¬ 
vant information in each subsystem and gives 
you a bearing when you find yourself in a 
part of Windows 95 that you never expected 
to end up in. 


4GB 


3GB 


2GB 


4MB 


0 



Soft-ICE is the only debugger 
that lets you debug VxDs at 
source level. 


You often have to step into 
the Windows 95 system DLLs 
to chase nasty bugs. When 
you do, make sure you have 
Soft-ICE because your application 
debugger won't do. 

If you are chasing a bug that 
involves 1 6-pit and 32-bit code, 
Soft-ICE will get you through the 
thunks at source level. Other 
debuggersfcan't. 


Your 32-bit application debugger 
leaves you trapped here. 


Soft-ICE lets you switch address 
contexts so you can debug 
multiple 32-bit applications 
simultaneously. 


Some of the most difficult bugs 
are the result of real mode 
programs, TSRs or drivers. 
Soft-ICE can debug these, as 
well as everything else in 
Windows 95. 


VxDS 

Dynamic VxDs 


32-bit 

System DLLs 


16-bit 

Windows 

Applications 


Win32 

Applications 


DOS 


System 

VM 


Boxes 


Whether you want to dig in and learn 
Windows 95 inside out, or you want to be 
prepared for the nastiest Windows bugs, 
make Soft-ICE 2.0 for Windows 95 a part of 
your tool kit. 



Windows 95 Memory Map 

Get Soft-ICE For Windows 95 
And Break The Barrier! 


Call 1 -800-4-NU-MEGA 

(1-800-468-6342) 

Risk = Null 30 Day Money Back Guarantee 


P.O.Box 7780 Nashua, NH 03060-7780 

Tel (603) 889-2386 • Fax (603) 889-1135 • info@numega.com 
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LIMITED TIME 
OFFER 

$399! 

PLUS SHIPPING 


Expires December 29, 1995. 
Regularly Priced At $499. 


http://www.njmega.com/ 

























